U
|
¬ý°d¸ ã @ sF d Z ddlmZ ddlmZ ddlmZmZ ddlZ ddl
|
m Z ddl m Z mZ ddlmZmZ dd lmZ dd
|
lmZmZ dd lmZ er¼dd lmZ dd lmZm Z ddl m Z m Z m Z ed'dddddddZ!ed(dddddddZ!ed)dddddddZ!d*d ddd dd dZ!d+ddd!d"d#Z"d,dd$d%d&Z#dS )-z
|
timedelta support tools
|
é )Ú annotations)Ú timedelta)Ú TYPE_CHECKINGÚoverloadN)Úlib)ÚNaTÚNaTType)Ú TimedeltaÚparse_timedelta_unit)Ú is_list_like)ÚABCIndexÚ ABCSeries)Úsequence_to_td64ns)Ú UnitChoices)Ú ArrayLikeÚDateTimeErrorChoices)ÚIndexÚSeriesÚTimedeltaIndex.zstr | float | timedeltazUnitChoices | Noner r )ÚargÚunitÚerrorsÚreturnc C s d S ©N© ©r r r r r úSd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\pandas/core/tools/timedeltas.pyÚ to_timedelta. s r r c C s d S r r r r r r r 7 s z(list | tuple | range | ArrayLike | Indexr c C s d S r r r r r r r @ s ÚraisezQstr | int | float | timedelta | list | tuple | range | ArrayLike | Index | Seriesz#Timedelta | TimedeltaIndex | Seriesc C s |dk rt |}|dkr td|dkr0td| dkr<| S t| trjt| j||d}| j|| j| jdS t| t rt| ||| jdS t| t
|
j r¨| j d kr¨t | ¡} n>t| rÎt| d
|
d d krÎt| ||dS t| d
|
d d krætd t| tr|dk rtd t| ||dS )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' / '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)
|
N)Úignorer Zcoercez5errors must be one of 'ignore', 'raise', or 'coerce'.> ÚMÚYÚyzqUnits 'M', 'Y', and 'y' are no longer supported, as they do not represent unambiguous timedelta values durations.©r r )ÚindexÚname)r r r% r Úndimé zBarg 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_listlikeZ_valuesZ _constructorr$ r% r ÚnpZndarrayr& r Zitem_from_zerodimr ÚgetattrÚ TypeErrorÚstrÚ _coerce_scalar_to_timedelta_type)r r r Úvaluesr r r r I s4 eÿ
|
|
ÿÚnsr# c C sF zt | |}W n2 tk
|
r@ |dkr( |dkr8| Y S t}Y nX |S )z)Convert string 'r' to a timedelta object.r r )r r( r )Úrr r Úresultr r r r/ Ö s
|
r/ )r c C s t | ttfst| ds8t| ds*t| } tj| td} zt| ||ddd }W n& tk
|
rv |dkrp| Y S Y nX ddl m
|
} ||d |d
|
}|S ) z6Convert a list of objects to a timedelta index object.ÚdtypeZ __array__)r4 F)r r Úcopyr r )r r1 )r r% ) r) ÚlistÚtupleÚhasattrr+ ÚarrayÚobjectr r( Úpandasr )r r r r% Ztd64arrr Úvaluer r r r* ê s
|
r* )..)..)..)Nr )r1 r )Nr N)$Ú__doc__Ú
|
__future__r Údatetimer Útypingr r Únumpyr+ Z pandas._libsr Zpandas._libs.tslibsr r Z pandas._libs.tslibs.timedeltasr r
|
Zpandas.core.dtypes.commonr Zpandas.core.dtypes.genericr r Z pandas.core.arrays.timedeltasr r Zpandas._typingr r r; r r r r r/ r* r r r r Ú<module> sJ ý ý ý ô ÿ ÿ
|
