o /iJ#@sdZddlZddlZddlZddlmZejdddejjdZdZ dZ e d ej Z d d Zd d ZddZddZddZddZddZeZdddZGdddejZdS)zHelpers for :mod:`datetime`.N) timestamp_pb2itzinfoz%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 cCstjjtjjdjddS)zEA :meth:`datetime.datetime.utcnow()` alias to allow mocking in tests.)tzNr)datetimenowtimezoneutcreplacer r T/var/www/passon-env/lib/python3.10/site-packages/google/api_core/datetime_helpers.pyutcnow+srcCst|}|dS)zConvert a zone-aware datetime to milliseconds since the unix epoch. Args: value (datetime.datetime): The datetime to covert. Returns: int: Milliseconds since the unix epoch. )to_microseconds)valuemicrosr r r to_milliseconds0s rcCsttj|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_EPOCHr timedeltarr r r from_microseconds=s rcCs@|js |jtjjd}|tjj}tt| d|j S)zConvert a datetime to microseconds since the unix epoch. Args: value (datetime.datetime): The datetime to covert. Returns: int: Microseconds since the unix epoch. r.A) rr rr r astimezoneintcalendartimegm timetuple microsecondrr r r rJs rcCtj|dS)zConvert a ISO8601 date string to a date. Args: value (str): The ISO8601 date string. Returns: datetime.date: A date equivalent to the date string. z%Y-%m-%d)rstrptimedaterr r r from_iso8601_date[ r#cCr )zConvert a zoneless ISO8601 time string to a time. Args: value (str): The ISO8601 time string. Returns: datetime.time: A time equivalent to the time string. z%H:%M:%S)rr!timerr r r from_iso8601_timegr$r&cCst|}|durtd|tjtj|dt}|d}|dur(d}ndt |}t |d|}|d}|j |tj j d S) a]Convert an RFC3339-format timestamp to a native datetime. Supported formats include those without fractional seconds, or with any fraction up to nanosecond precision. .. note:: Python datetimes do not support nanosecond precision; this function therefore truncates such values to microseconds. Args: value (str): The RFC3339 string to convert. Returns: datetime.datetime: The datetime object equivalent to the timestamp in UTC. Raises: ValueError: If the timestamp does not match the RFC3339 regular expression. Nz-Timestamp: {!r}, does not match pattern: {!r} no_fractionnanosr r)rr)_RFC3339_NANOSmatch ValueErrorformatpatternrr!group_RFC3339_NO_FRACTIONlenrr r r )r with_nanos bare_secondsfractionrscaler(r r r from_rfc3339ss"    r7TcCs,|s|jdur|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. Nr)rr utcoffsetstrftime_RFC3339_MICROS)r ignore_zoner r r to_rfc3339s  r<c@sPeZdZdZdZddZeddZddZe d d Z d d Z e d dZ dS)DatetimeWithNanosecondszuTrack nanosecond in addition to normal datetime attrs. Nanosecond can be passed only as a keyword argument.  _nanosecondcOsX|dd}|dkrd|vrtd|d|d<tjj|g|Ri|}|p(d|_|S)N nanosecondrrz1Specify only one of 'microsecond' or 'nanosecond'r)pop TypeErrorr__new__r?)clsargskwr(instr r r rCs   zDatetimeWithNanoseconds.__new__cCs|jS)z Read-only: nanosecond precision.r>)selfr r r r@sz"DatetimeWithNanoseconds.nanosecondcCs<|jdkr t|St|jddd}d|t|S)zReturn an RFC3339-compliant timestamp. Returns: (str): Timestamp string according to RFC3339 spec. rr)0z{}.{}Z)r?r<strrjustrstripr.r9r1)rHr(r r r rfc3339s zDatetimeWithNanoseconds.rfc3339c Cst|}|durtd|tjtj|dt}|d}|dur(d}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: {}r'r(rr)r*r@r)r+r,r-r.r/rr!r0r1r2ryearmonthdayhourminutesecondr r )rDstampr3barer5r(r6r r r r7s2    z$DatetimeWithNanoseconds.from_rfc3339cCsP|jdur|n|jtjjd}|t}t|}|jp |j d}t j ||dS)zReturn a timestamp message. Returns: (:class:`~google.protobuf.timestamp_pb2.Timestamp`): Timestamp message Nrr)secondsr() rr rr r rr total_secondsr?rr Timestamp)rHrGdeltarWr(r r r 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 rrN) rrWrrOrPrQrRrSrTr(rr r )rDrUrrVr r r from_timestamp_pbs z)DatetimeWithNanoseconds.from_timestamp_pbN) __name__ __module__ __qualname____doc__ __slots__rCpropertyr@rM classmethodr7r[r\r r r r r=s  (r=)T)r`rrregoogle.protobufrr r rr:r1compileVERBOSEr+rrrrr#r&r7from_rfc3339_nanosr<r=r r r r s,      -