o Zh= @s dZddlZddlmZddlmZdedefddZd edefd d Z d edefd dZ dedefddZ dedefddZ defddZ dedefddZdedefddZdedefddZdedefddZdedefd d!Z d%ded"eejdejfd#d$ZdS)&z#Contains the Timestamp helper APIs.N)Optional) TimestampvaluereturncCt}|||S)a<Parse a RFC 3339 date string format to Timestamp. Args: value: A date string. Any fractional digits (or none) and any offset are accepted as long as they fit into nano-seconds precision. Example of accepted format: '1972-01-01T10:00:20.021-05:00' Raises: ValueError: On parsing problems. )rZFromJsonString)r timestamprP/var/www/html/lang_env/lib/python3.10/site-packages/google/protobuf/timestamp.pyfrom_json_strings r microscCr)z/Converts microseconds since epoch to Timestamp.)rZFromMicroseconds)r rrrr from_microseconds  r milliscCr)z/Converts milliseconds since epoch to Timestamp.)rZFromMilliseconds)rrrrr from_milliseconds'r rnanoscCr)z.Converts nanoseconds since epoch to Timestamp.)rZFromNanoseconds)rrrrr from_nanoseconds.r rsecondscCr)z*Converts seconds since epoch to Timestamp.)rZ FromSeconds)rrrrr from_seconds5r rcCs"t}|tjjtjjd|S)z&Converts the current UTC to Timestamp.)tz)rZ FromDatetimedatetimenowtimezoneutc)rrrr from_current_time<srtscC|S)aConverts Timestamp to RFC 3339 date string format. Returns: A string converted from timestamp. The string is always Z-normalized and uses 3, 6 or 9 fractional digits as required to represent the exact time. Example of the return format: '1972-01-01T10:00:20.021Z' )Z ToJsonStringrrrr to_json_stringCsrcCr)z/Converts Timestamp to microseconds since epoch.)ZToMicrosecondsrrrr to_microsecondsNrcCr)z/Converts Timestamp to milliseconds since epoch.)ZToMillisecondsrrrr to_millisecondsSrr cCr)z.Converts Timestamp to nanoseconds since epoch.)Z ToNanosecondsrrrr to_nanosecondsXrr!cCr)z*Converts Timestamp to seconds since epoch.)Z ToSecondsrrrr to_seconds]rr"rcCs |j|dS)a7Converts Timestamp to a datetime. Args: tz: A datetime.tzinfo subclass; defaults to None. Returns: If tzinfo is None, returns a timezone-naive UTC datetime (with no timezone information, i.e. not aware that it's UTC). Otherwise, returns a timezone-aware datetime in the input timezone. )tzinfo)Z ToDatetime)rrrrr to_datetimebs r$)N)__doc__rtypingrZgoogle.protobuf.timestamp_pb2rstrr floatr rrrrrintrr r!r"r#r$rrrr s.