jvdZddlmZddlmZmZmZddlZddl 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)ed! d0d1d%Z) d2d3d(Z* d4d5d+Z+dS)6z timedelta support tools ) annotations) TYPE_CHECKINGAnyoverloadN)lib)NaTNaTType) Timedeltadisallow_ambiguous_unitparse_timedelta_unit) set_module) is_list_like) ArrowDtype)ABCIndex ABCSeries)sequence_to_td64ns)Hashable) timedelta) UnitChoices) ArrayLikeDateTimeErrorChoices)IndexSeriesTimedeltaIndex.argstr | float | timedeltaunitUnitChoices | Noneerrorsrreturnr cdSNrrrs JC:\Projects\DSCons\.venv\Lib\site-packages\pandas\core\tools\timedeltas.py to_timedeltar&5s rcdSr"r#r$s r%r&r&=s Sr'(list | tuple | range | ArrayLike | IndexrcdSr"r#r$s r%r&r&Es Sr'pandasraiseQstr | int | float | timedelta | list | tuple | range | ArrayLike | Index | Series3Timedelta | TimedeltaIndex | Series | NaTType | Anyc|t|}t||dvrtd|tSt |t r9t |j||}|||j |j St |trt ||||j St |tj r |jdkrtj|}nZt#|r't%|dd d krt |||St%|dd d krt'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. .. 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' * 'm' / 'minute' / 'min' / 'minutes' * 's' / 'seconds' / 'sec' / 'second' * 'ms' / 'milliseconds' / 'millisecond' / 'milli' / 'millis' * 'us' / 'microseconds' / 'microsecond' / 'micro' / 'micros' * 'ns' / 'nanoseconds' / 'nano' / 'nanos' / 'nanosecond' Must not be specified when `arg` contains strings and ``errors="raise"``. errors : {'raise', 'coerce'}, default 'raise' - If 'raise', then invalid parsing will raise an exception. - If 'coerce', then invalid parsing will be set as NaT. 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[s]', freq=None) >>> pd.to_timedelta(np.arange(5), unit="D") TimedeltaIndex(['0 days', '1 days', '2 days', '3 days', '4 days'], dtype='timedelta64[s]', freq=None) N)r,coercez+errors must be one of 'raise', or 'coerce'.)rr)indexname)rrr2rndimzBarg 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 ValueErrorr isinstancer_convert_listlike_values _constructorr1r2rnpndarrayr3ritem_from_zerodimrgetattr TypeErrorstr _coerce_scalar_to_timedelta_type)rrrvaluess r%r&r&MsD #D))%%% (((FGGG { C # # "3;T&IIIcichGGG C " "  4SXNNNN C $ $  Q #C(( c   wsFA66!;; 4???? fa 1 $ $ P   #sV 0TUUU ,Cd6 J J JJr'nsTimedelta | NaTTypecf t||}n#t$r|dkrt}YnwxYw|S)z)Convert string 'r' to a timedelta object.r,)r r5r)rrrresults r%r@r@sQ 1d##  W     Ms ..r2Hashable | Noneclt|dd}t|ttfs|t j|t }n"t|tr |jdkr|St|||dd}ddl m }||upt j ||}|||| }|S) z6Convert a list of objects to a timedelta index object.dtypeN)rImF)rrcopyr)r)r2rK) r=r6listtupler:arrayobjectrkindrr+rmay_share_memory) rrrr2 arg_dtypetd64arrrrKvalues r%r7r7sWd++I#e}%%):hs&))) Iz * *y~/D/D  4UKKKANG%%%%%% c> >R0g>>D N7D 9 9 9E Lr')..)rrrrrrr r )rrrrrrr r)rr)rrrrr r)Nr,)rr-rrrrr r.)rBr,)rrrrr rC)Nr,N)rrrrr2rG),__doc__ __future__rtypingrrrnumpyr: pandas._libsrpandas._libs.tslibsrr pandas._libs.tslibs.timedeltasr r r pandas.util._decoratorsr pandas.core.dtypes.commonrpandas.core.dtypes.dtypesrpandas.core.dtypes.genericrrpandas.core.arrays.timedeltasrcollections.abcrdatetimerrpandas._typingrrr+rrrr&r@r7r#r'r%rds#"""""  /.....222222000000 =<<<<<((((((""""""::::::   ##&   ##&   ##&  H $#*AKAKAKAKAKJHO& $#* r'