+
    oi=                         R t ^ RIt^ RIHt ^ RIHt R R ltR R ltR R	 ltR
 R lt	R R lt
R R ltR R ltR R ltR R ltR R ltR R ltRR R lltR# )z#Contains the Timestamp helper APIs.N)Optional	Timestampc                0    V ^8  d   QhR\         R\        /# )   valuereturn)strr   )formats   "|/Users/tonyclaw/.openclaw/workspace/scripts/youtube-playlists/venv/lib/python3.14/site-packages/google/protobuf/timestamp.py__annotate__r      s      C I     c                <    \        4       pVP                  V 4       V# )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.
)r   FromJsonString)r   	timestamps   & r   from_json_stringr      s     k)5!	r   c                0    V ^8  d   QhR\         R\        /# )r   microsr   floatr   )r
   s   "r   r   r             e 	 r   c                <    \        4       pVP                  V 4       V# )z/Converts microseconds since epoch to Timestamp.)r   FromMicroseconds)r   r   s   & r   from_microsecondsr           k)V$	r   c                0    V ^8  d   QhR\         R\        /# )r   millisr   r   )r
   s   "r   r   r   '   r   r   c                <    \        4       pVP                  V 4       V# )z/Converts milliseconds since epoch to Timestamp.)r   FromMilliseconds)r   r   s   & r   from_millisecondsr   '   r   r   c                0    V ^8  d   QhR\         R\        /# )r   nanosr   r   )r
   s   "r   r   r   .   s      E i r   c                <    \        4       pVP                  V 4       V# )z.Converts nanoseconds since epoch to Timestamp.)r   FromNanoseconds)r!   r   s   & r   from_nanosecondsr$   .   s    k)E"	r   c                0    V ^8  d   QhR\         R\        /# )r   secondsr   r   )r
   s   "r   r   r   5   s      % I r   c                <    \        4       pVP                  V 4       V# )z*Converts seconds since epoch to Timestamp.)r   FromSeconds)r&   r   s   & r   from_secondsr)   5   s    k) 	r   c                $    V ^8  d   QhR\         /# )r   r   r   )r
   s   "r   r   r   <   s      9 r   c                     \        4       p V P                  \        P                  P                  \        P                  P
                  R7      4       V # )z&Converts the current UTC to Timestamp.)tz)r   FromDatetimedatetimenowtimezoneutc)r   s    r   from_current_timer2   <   s=    k)**..(2C2C2G2G.HI	r   c                0    V ^8  d   QhR\         R\        /# r   tsr   )r   r	   )r
   s   "r   r   r   C   s      y S r   c                "    V P                  4       # )a  Converts 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'
)ToJsonStringr5   s   &r   to_json_stringr9   C   s     
	r   c                0    V ^8  d   QhR\         R\        /# r4   r   int)r
   s   "r   r   r   N         	 c r   c                "    V P                  4       # )z/Converts Timestamp to microseconds since epoch.)ToMicrosecondsr8   s   &r   to_microsecondsr@   N       				r   c                0    V ^8  d   QhR\         R\        /# r4   r;   )r
   s   "r   r   r   S   r=   r   c                "    V P                  4       # )z/Converts Timestamp to milliseconds since epoch.)ToMillisecondsr8   s   &r   to_millisecondsrE   S   rA   r   c                0    V ^8  d   QhR\         R\        /# r4   r;   )r
   s   "r   r   r   X   s      y S r   c                "    V P                  4       # )z.Converts Timestamp to nanoseconds since epoch.)ToNanosecondsr8   s   &r   to_nanosecondsrI   X   s    				r   c                0    V ^8  d   QhR\         R\        /# r4   r;   )r
   s   "r   r   r   ]   s      9  r   c                "    V P                  4       # )z*Converts Timestamp to seconds since epoch.)	ToSecondsr8   s   &r   
to_secondsrM   ]   s    	r   c                z    V ^8  d   QhR\         R\        \        P                  ,          R\        P                  /# )r   r5   r,   r   )r   r   r.   tzinfo)r
   s   "r   r   r   b   s3     " ""0""r   c                &    V P                  VR7      # )a)  Converts 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.
)rO   )
ToDatetime)r5   r,   s   &&r   to_datetimerR   b   s     
b	!!r   )N)__doc__r.   typingr   google.protobuf.timestamp_pb2r   r   r   r   r$   r)   r2   r9   r@   rE   rI   rM   rR    r   r   <module>rW      sT    *   3 



" "r   