U ڲg@sxdZddlZddlZddlZddlmZejdejjZ dZ dZ e dej ZddZdd d ZGd d d ejZdS)zHelpers for :mod:`datetime`.N) timestamp_pb2z%Y-%m-%dT%H:%M:%S.%fZz%Y-%m-%dT%H:%M:%Sah (?P \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2} # YYYY-MM-DDTHH:MM:SS ) ( # Optional decimal part \. # decimal point (?P\d{1,9}) # nanoseconds, maybe truncated )? Z # Zulu cCsttj|dS)aConvert timestamp in microseconds since the unix epoch to datetime. Args: value (float): The timestamp to convert, in microseconds. Returns: datetime.datetime: The datetime object equivalent to the timestamp in UTC. ) microseconds) _UTC_EPOCHdatetime timedelta)valuer:/tmp/pip-unpacked-wheel-zasgy6sz/proto/datetime_helpers.py_from_microseconds,s r TcCs,|s"|jdk r"|jdd|}|tS)aConvert a datetime to an RFC3339 timestamp string. Args: value (datetime.datetime): The datetime object to be converted to a string. ignore_zone (bool): If True, then the timezone (if any) of the datetime object is ignored and the datetime is treated as UTC. Returns: str: The RFC3339 formatted string representing the datetime. Ntzinfo)r replace utcoffsetstrftime_RFC3339_MICROS)rZ ignore_zonerrr _to_rfc33399s rcs`eZdZdZdZddZfddZeddZd d Z e d d Z d dZ e ddZ ZS)DatetimeWithNanosecondszuTrack nanosecond in addition to normal datetime attrs. Nanosecond can be passed only as a keyword argument. ) _nanosecondcOsR|dd}|dkr0d|kr$td|d|d<tjj|f||}|pJd|_|S)N nanosecondr microsecond1Specify only one of 'microsecond' or 'nanosecond')pop TypeErrorr__new__r)clsargskwnanosinstrrr rUs   zDatetimeWithNanoseconds.__new__csxd|k}d|k}|dd}|j}|r2|r2td|rB|d|d<tj||}|rb|jd|_n|rn||_n||_|S)a@Return a date with the same value, except for those parameters given new values by whichever keyword arguments are specified. For example, if d == date(2002, 12, 31), then d.replace(day=26) == date(2002, 12, 26). NOTE: nanosecond and microsecond are mutually exclusive arguments. rrrrr)rrrsuperr rr)selfrrZ ms_providedZ ns_providedZ provided_nsZ prev_nanosr __class__rr r `s  zDatetimeWithNanoseconds.replacecCs|jp|jdS)z Read-only: nanosecond precision.r)rr)r!rrr rsz"DatetimeWithNanoseconds.nanosecondcCs<|jdkrt|St|jddd}d|t|S)zReturn an RFC3339-compliant timestamp. Returns: (str): Timestamp string according to RFC3339 spec. r 0z{}.{}Z)rrstrrjustrstripformatr_RFC3339_NO_FRACTION)r!rrrr rfc3339s zDatetimeWithNanoseconds.rfc3339c Cst|}|dkr$td|tjtj|dt}|d}|dkrPd}ndt |}t |d|}||j |j |j |j|j|j|tjjdS) akParse RFC3339-compliant timestamp, preserving nanoseconds. Args: stamp (str): RFC3339 stamp, with up to nanosecond precision Returns: :class:`DatetimeWithNanoseconds`: an instance matching the timestamp string Raises: ValueError: if `stamp` does not match the expected format Nz)Timestamp: {}, does not match pattern: {}Z no_fractionrrr$ rr )_RFC3339_NANOSmatch ValueErrorr)patternrstrptimegroupr*lenintyearmonthdayhourminutesecondtimezoneutc)rstampZ with_nanosbarefractionrZscalerrr from_rfc3339s6   z$DatetimeWithNanoseconds.from_rfc3339cCsP|jdk r|n|jtjjd}|t}t|}|jp@|j d}t j ||dS)zReturn a timestamp message. Returns: (:class:`~google.protobuf.timestamp_pb2.Timestamp`): Timestamp message Nr r)secondsr) r r rr<r=rr5 total_secondsrrrZ Timestamp)r!rdeltarBrrrr timestamp_pbs z$DatetimeWithNanoseconds.timestamp_pbc Cs@t|jd}t|}||j|j|j|j|j|j|j t j j dS)a&Parse RFC3339-compliant timestamp, preserving nanoseconds. Args: stamp (:class:`~google.protobuf.timestamp_pb2.Timestamp`): timestamp message Returns: :class:`DatetimeWithNanoseconds`: an instance matching the timestamp message g.Ar-) r5rBr r6r7r8r9r:r;rrr<r=)rr>rr?rrr from_timestamp_pbs z)DatetimeWithNanoseconds.from_timestamp_pb)__name__ __module__ __qualname____doc__ __slots__rr propertyrr+ classmethodrArErF __classcell__rrr"r rLs "   (r)T)rJcalendarrreZgoogle.protobufr fromtimestampr<r=rrr*compileVERBOSEr.r rrrrrr s