`Vg&^dZddlmZddlmZddlmZmZddlZ ddl m Z ddl m Z mZddlmZmZdd lmZdd lmZmZdd lmZerdd lmZdd lmZmZddlmZmZm Z e d ddZ!e d ddZ!e d ddZ! d ddZ!ddZ"ddZ#y)z timedelta support tools ) annotations) timedelta) TYPE_CHECKINGoverloadN)lib)NaTNaTType) Timedeltaparse_timedelta_unit) is_list_like)ABCIndex ABCSeries)sequence_to_td64ns) UnitChoices) ArrayLikeDateTimeErrorChoices)IndexSeriesTimedeltaIndexcyNarguniterrorss ]/var/www/html/hubwallet-dev/venv/lib/python3.12/site-packages/pandas/core/tools/timedeltas.py to_timedeltar. cyrrrs rrr7rr cyrrrs rrr@rr c| t|}|dvr td|dvr td||St|tr@t |j ||}|j ||j|jSt|trt ||||jSt|tjr%|jdk(rtj|}nDt|rt!|d d d k(rt |||St!|d d d kDr t#d t|t$r | td t'|||S) a Convert argument to timedelta. Timedeltas are absolute differences in times, expressed in difference units (e.g. days, hours, minutes, seconds). This method converts an argument from a recognized timedelta format / value into a Timedelta type. Parameters ---------- arg : str, timedelta, list-like or Series The data to be converted to timedelta. .. deprecated:: 1.2 Strings with units 'M', 'Y' and 'y' do not represent unambiguous timedelta values and will be removed in a future version unit : str, optional Denotes the unit of the arg for numeric `arg`. Defaults to ``"ns"``. Possible values: * 'W' * 'D' / 'days' / 'day' * 'hours' / 'hour' / 'hr' / 'h' * 'm' / 'minute' / 'min' / 'minutes' / 'T' * 'S' / 'seconds' / 'sec' / 'second' * 'ms' / 'milliseconds' / 'millisecond' / 'milli' / 'millis' / 'L' * 'us' / 'microseconds' / 'microsecond' / 'micro' / 'micros' / 'U' * 'ns' / 'nanoseconds' / 'nano' / 'nanos' / 'nanosecond' / 'N' .. versionchanged:: 1.1.0 Must not be specified when `arg` context strings and ``errors="raise"``. errors : {'ignore', 'raise', 'coerce'}, default 'raise' - If 'raise', then invalid parsing will raise an exception. - If 'coerce', then invalid parsing will be set as NaT. - If 'ignore', then invalid parsing will return the input. Returns ------- timedelta If parsing succeeded. Return type depends on input: - list-like: TimedeltaIndex of timedelta64 dtype - Series: Series of timedelta64 dtype - scalar: Timedelta See Also -------- DataFrame.astype : Cast argument to a specified dtype. to_datetime : Convert argument to datetime. convert_dtypes : Convert dtypes. Notes ----- If the precision is higher than nanoseconds, the precision of the duration is truncated to nanoseconds for string inputs. Examples -------- Parsing a single string to a Timedelta: >>> pd.to_timedelta('1 days 06:05:01.00003') Timedelta('1 days 06:05:01.000030') >>> pd.to_timedelta('15.5us') Timedelta('0 days 00:00:00.000015500') Parsing a list or array of strings: >>> pd.to_timedelta(['1 days 06:05:01.00003', '15.5us', 'nan']) TimedeltaIndex(['1 days 06:05:01.000030', '0 days 00:00:00.000015500', NaT], dtype='timedelta64[ns]', freq=None) Converting numbers by specifying the `unit` keyword argument: >>> pd.to_timedelta(np.arange(5), unit='s') TimedeltaIndex(['0 days 00:00:00', '0 days 00:00:01', '0 days 00:00:02', '0 days 00:00:03', '0 days 00:00:04'], dtype='timedelta64[ns]', freq=None) >>> pd.to_timedelta(np.arange(5), unit='d') TimedeltaIndex(['0 days', '1 days', '2 days', '3 days', '4 days'], dtype='timedelta64[ns]', freq=None) )ignoreraisecoercez5errors must be one of 'ignore', 'raise', or 'coerce'.>MYyzqUnits 'M', 'Y', and 'y' are no longer supported, as they do not represent unambiguous timedelta values durations.)rr)indexname)rrr+rndimzBarg must be a string, timedelta, list, tuple, 1-d array, or Seriesz9unit must not be specified if the input is/contains a str)r ValueError isinstancer_convert_listlike_values _constructorr*r+r npndarrayr,ritem_from_zerodimr getattr TypeErrorstr _coerce_scalar_to_timedelta_type)rrrvaluess rrrIsLJ #D) 22PQQ  @   { C #"3;;T&IciichhGG C " 4SXXNN C $Q ##C( c wsFA6!; 4?? fa 1 $ P  #s 0TUU ,Cd6 JJr cj t||}|S#t$r|dk(r|dk(r|cYSt}Y|SwxYw)z)Convert string 'r' to a timedelta object.r%r$)r r.r)rrrresults rr9r9sO 1d# M  W   x H Ms 222ct|ttfs t|ds$t j t|t } t|||dd}ddl m }||d| }|S#t$r |dk(r|cYSwxYw) z6Convert a list of objects to a timedelta index object.dtype)r?F)rrcopyrr$)rns)rr+) r/listtuplehasattrr3arrayobjectrr.pandasr)rrrr+td64arrrvalues rr0r0s#e}%WS'-B hhtCy/ $StFOPQR& 7D 9E L!   X J  sA--B?B)..)rzstr | float | timedeltarUnitChoices | Nonerrreturnr )rrrrJrrrKr)rz(list | tuple | range | ArrayLike | IndexrrJrrrKr)Nr%)rzQstr | int | float | timedelta | list | tuple | range | ArrayLike | Index | SeriesrrJrrrKz#Timedelta | TimedeltaIndex | Series)rAr%)Nr%N)$__doc__ __future__rdatetimertypingrrnumpyr3 pandas._libsrpandas._libs.tslibsrr pandas._libs.tslibs.timedeltasr r pandas.core.dtypes.commonr pandas.core.dtypes.genericr rpandas.core.arrays.timedeltasrrpandas._typingrrrGrrrrr9r0rr rrXsW#  3 =:   ##&   !    ##&   !    ##& 1  !  & $#*JK JK JK !JK)JKZ$r