E g"vdZddlmZddlmZmZddlZddlZddl m Z ddl m Z m Z ddlmZmZmZddlmZdd lmZdd lmZdd lmZmZdd lmZer$dd lmZddlm Z ddlm!Z!ddl"m#Z#m$Z$ddl%m&Z&m'Z'm(Z(e d*d+dZ)e d*d,dZ)e d*d-d Z) d.d/d$Z) d0d1d&Z* d2d3d)Z+dS)4z timedelta support tools ) annotations) TYPE_CHECKINGoverloadN)lib)NaTNaTType) Timedeltadisallow_ambiguous_unitparse_timedelta_unit)find_stack_level) is_list_like) ArrowDtype)ABCIndex ABCSeries)sequence_to_td64ns)Hashable) timedelta) UnitChoices) ArrayLikeDateTimeErrorChoices)IndexSeriesTimedeltaIndex.argstr | float | timedeltaunitUnitChoices | Noneerrorsrreturnr cdSNrrrs Q/var/www/sysmax/venv/lib/python3.11/site-packages/pandas/core/tools/timedeltas.py to_timedeltar%4 CrcdSr!r"r#s r$r%r%=r&r'(list | tuple | range | ArrayLike | IndexrcdSr!r"r#s r$r%r%Fr&r'raiseQstr | int | float | timedelta | list | tuple | range | ArrayLike | Index | Series#Timedelta | TimedeltaIndex | SeriescZ|t|}t||dvrtd|dkr(tjdt t ||St|tr9t|j ||}| ||j |j St|trt||||j St|tjr |jd krt%j|}nZt)|r't+|d d d krt|||St+|d d d krt-d t|t.r|tdt1|||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. .. versionchanged:: 2.0 Strings with units 'M', 'Y' and 'y' do not represent unambiguous timedelta values and will raise an exception. 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' / 'H' * 'm' / 'minute' / 'min' / 'minutes' / 'T' * 's' / 'seconds' / 'sec' / 'second' / 'S' * 'ms' / 'milliseconds' / 'millisecond' / 'milli' / 'millis' / 'L' * 'us' / 'microseconds' / 'microsecond' / 'micro' / 'micros' / 'U' * 'ns' / 'nanoseconds' / 'nano' / 'nanos' / 'nanosecond' / 'N' Must not be specified when `arg` contains strings and ``errors="raise"``. .. deprecated:: 2.2.0 Units 'H', 'T', 'S', 'L', 'U' and 'N' are deprecated and will be removed in a future version. Please use 'h', 'min', 's', 'ms', 'us', and 'ns' instead of 'H', 'T', 'S', 'L', 'U' and 'N'. 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) N)ignorer+coercez5errors must be one of 'ignore', 'raise', or 'coerce'.r/zerrors='ignore' is deprecated and will raise in a future version. Use to_timedelta without passing `errors` and catch exceptions explicitly instead) stacklevel)rr)indexname)rrr3rndimzBarg must be a string, timedelta, list, tuple, 1-d array, or Seriesz9unit must not be specified if the input is/contains a str)r r ValueErrorwarningswarn FutureWarningr isinstancer_convert_listlike_values _constructorr2r3rnpndarrayr4ritem_from_zerodimr getattr TypeErrorstr _coerce_scalar_to_timedelta_type)rrrvaluess r$r%r%OsN #D))%%% 222PQQQ   ! '))      { C # # "3;T&IIIcichGGG C " "  4SXNNNN C $ $  Q #C(( c   wsFA66!;; 4???? fa 1 $ $ P   #sV 0TUUU ,Cd6 J J JJr'nscz t||}n(#t$r|dkr|dkr|cYSt}YnwxYw|S)z)Convert string 'r' to a timedelta object.r+r/)r r6r)rrrresults r$rDrDsg 1d##  W    X  HHH Ms888r3Hashable | Nonect|dd}t|ttfs|;t |dst|}t j|t}n"t|tr |j dkr|S t|||dd}n#t$r |d kr|cYSwxYwdd l m }||| }|S) z6Convert a list of objects to a timedelta index object.dtypeN __array__)rLmF)rrcopyrr/)r)r3)rAr:listtuplehasattrr>arrayobjectrkindrr6pandasr)rrrr3 arg_dtypetd64arrrvalues r$r;r;s Wd++I#e}%% ): sK(( s))Chs&))) Iz * *y~/D/D  $StFOOOPQR     X  JJJ  &%%%%% N7 . . .E LsB((B><B>)..)rrrrrrrr )rrrrrrrr)rr)rrrrrr)Nr+)rr,rrrrrr-)rFr+)rrrr)Nr+N)rrrrr3rJ),__doc__ __future__rtypingrrr7numpyr> pandas._libsrpandas._libs.tslibsrrpandas._libs.tslibs.timedeltasr r r pandas.util._exceptionsr pandas.core.dtypes.commonr pandas.core.dtypes.dtypesrpandas.core.dtypes.genericrrpandas.core.arrays.timedeltasrcollections.abcrdatetimerrpandas._typingrrrVrrrr%rDr;r"r'r$ris#""""" 544444222222000000 =<<<<<((((((""""""::::::   ##&   ##&   ##& & $#*PKPKPKPKPKhHO, $#* %%%%%%%r'