<h2>Editing File: /lib/python3.6/site-packages/pyrfc3339/parser.py</h2><form method='post'><textarea name='content' class='file-edit'>import re
from datetime import datetime

import pytz

from pyrfc3339.utils import FixedOffset


def parse(timestamp, utc=False, produce_naive=False):
    '''
    Parse an :RFC:`3339`-formatted timestamp and return a
    `datetime.datetime`.

    If the timestamp is presented in UTC, then the `tzinfo` parameter of the
    returned `datetime` will be set to `pytz.utc`.

    &gt;&gt;&gt; parse('2009-01-01T10:01:02Z')
    datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=&lt;UTC&gt;)

    Otherwise, a `tzinfo` instance is created with the appropriate offset, and
    the `tzinfo` parameter of the returned `datetime` is set to that value.

    &gt;&gt;&gt; parse('2009-01-01T14:01:02-04:00')
    datetime.datetime(2009, 1, 1, 14, 1, 2, tzinfo=&lt;UTC-04:00&gt;)

    However, if `parse()`  is called with `utc=True`, then the returned
    `datetime` will be normalized to UTC (and its tzinfo parameter set to
    `pytz.utc`), regardless of the input timezone.

    &gt;&gt;&gt; parse('2009-01-01T06:01:02-04:00', utc=True)
    datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=&lt;UTC&gt;)

    The input is strictly required to conform to :RFC:`3339`, and appropriate
    exceptions are thrown for invalid input.

    &gt;&gt;&gt; parse('2009-01-01T06:01:02')
    Traceback (most recent call last):
    ...
    ValueError: timestamp does not conform to RFC 3339

    &gt;&gt;&gt; parse('2009-01-01T25:01:02Z')
    Traceback (most recent call last):
    ...
    ValueError: hour must be in 0..23

    '''

    parse_re = re.compile(r'''^(?:(?:(?P&lt;date_fullyear&gt;[0-9]{4})\-(?P&lt;date_month&gt;[0-9]{2})\-(?P&lt;date_mday&gt;[0-9]{2}))T(?:(?:(?P&lt;time_hour&gt;[0-9]{2})\:(?P&lt;time_minute&gt;[0-9]{2})\:(?P&lt;time_second&gt;[0-9]{2})(?P&lt;time_secfrac&gt;(?:\.[0-9]{1,}))?)(?P&lt;time_offset&gt;(?:Z|(?P&lt;time_numoffset&gt;(?P&lt;time_houroffset&gt;(?:\+|\-)[0-9]{2})\:(?P&lt;time_minuteoffset&gt;[0-9]{2}))))))$''',
                          re.I | re.X)

    match = parse_re.match(timestamp)

    if match is not None:
        if match.group('time_offset') in [&quot;Z&quot;, &quot;z&quot;, &quot;+00:00&quot;, &quot;-00:00&quot;]:
            if produce_naive is True:
                tzinfo = None
            else:
                tzinfo = pytz.utc
        else:
            if produce_naive is True:
                raise ValueError(&quot;cannot produce a naive datetime from &quot; +
                                 &quot;a local timestamp&quot;)
            else:
                tzinfo = FixedOffset(int(match.group('time_houroffset')),
                                     int(match.group('time_minuteoffset')))

        secfrac = match.group('time_secfrac')
        if secfrac is None:
            microsecond = 0
        else:
            microsecond = int(round(float(secfrac) * 1000000))

        dt_out = datetime(year=int(match.group('date_fullyear')),
                          month=int(match.group('date_month')),
                          day=int(match.group('date_mday')),
                          hour=int(match.group('time_hour')),
                          minute=int(match.group('time_minute')),
                          second=int(match.group('time_second')),
                          microsecond=microsecond,
                          tzinfo=tzinfo)

        if utc:
            dt_out = dt_out.astimezone(pytz.utc)

        return dt_out
    else:
        raise ValueError(&quot;timestamp does not conform to RFC 3339&quot;)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib%2Fpython3.6%2Fsite-packages%2Fpyrfc3339'>Back to Directory</a>