Function parse_rfc3339

kubernetes/base/config/dateutil.py:50–99

(s)

def parse_rfc3339(s):
    if isinstance(s, datetime.datetime):
        if not s.tzinfo:
            return s.replace(tzinfo=UTC)
        return s
    
    m = _re_rfc3339.fullmatch(s.strip())
    if m is None:
        raise ValueError(
            f"Invalid RFC3339 datetime: {s!r} "
            "(expected YYYY-MM-DDTHH:MM:SS[.frac][Z|±HH:MM])"
        )
    
    groups = m.groups()
    dt = [0] * 7
    for x in range(6):
        dt[x] = int(groups[x])
    
    us = 0
    if groups[6] is not None:
        partial_sec = float(groups[6].replace(",", "."))
        us = int(MICROSEC_PER_SEC * partial_sec)
    
    tz = UTC
    if groups[7] is not None and groups[7] not in ('Z', 'z', ' '):
        tz_match = _re_timezone.search(groups[7])
        if tz_match is None:
            raise ValueError(
                f"Invalid timezone format in RFC3339 string {s!r}: "
                f"timezone part {groups[7]!r} does not match expected "
                f"format (±HH:MM)"
            )
        tz_groups = tz_match.groups()
        hour = int(tz_groups[1])
        minute = 0
        if tz_groups[0] == "-":
            hour *= -1
        if tz_groups[2]:
            minute = int(tz_groups[2])
        tz = TimezoneInfo(hour, minute)
    
    try:
        return datetime.datetime(
            year=dt[0], month=dt[1], day=dt[2],
            hour=dt[3], minute=dt[4], second=dt[5],
            microsecond=us, tzinfo=tz)
    except ValueError as e:
        raise ValueError(
            f"Invalid date/time values in RFC3339 string {s!r}: {e}"
        ) from e