pandas.to_timedelta

pandas.to_timedelta(arg, unit='ns', box=True, errors='raise') [source]

Преобразование аргумента в тип timedelta.

Значения timedelta представляют собой абсолютные временные разницы, выраженные в единицах разности (например, днях, часах, минутах, секундах). Этот метод преобразует аргумент из распознаваемого формата/значения timedelta в тип Timedelta.

Параметры:

arg : str, timedelta, list-like or Series Данные, которые необходимо преобразовать в timedelta. unit : str, default ‘ns’ Обозначает единицу измерения аргумента. Возможные значения: (‘Y’, ‘M’, ‘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’). box : bool, default True Если True, возвращает Timedelta/TimedeltaIndex результатов. Если False, возвращает numpy.timedelta64 или numpy.darray значений типа timedelta64[ns]. errors : {‘ignore’, ‘raise’, ‘coerce’}, default ‘raise’ Если ‘raise’, некорректный разбор вызовет исключение. Если ‘coerce’, некорректный разбор будет установлен как NaT. Если ‘ignore’, некорректный разбор вернёт входные данные.

Возвращает:

timedelta64 или numpy.array timedelta64 Тип результата, возвращаемый при успешном разборе.

См. также

DataFrame.astype

Преобразование аргумента к указанному типу данных.

to_datetime

Преобразование аргумента в тип datetime.

Примеры

Разбор одной строки в 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.000015')

Разбор списка или массива строк:

>>> pd.to_timedelta(['1 days 06:05:01.00003', '15.5us', 'nan'])
TimedeltaIndex(['1 days 06:05:01.000030', '0 days 00:00:00.000015', NaT],
               dtype='timedelta64[ns]', freq=None)

Преобразование чисел, указав ключевой аргумент unit:

>>> pd.to_timedelta(np.arange(5), unit='s')
TimedeltaIndex(['00:00:00', '00:00:01', '00:00:02',
                '00:00:03', '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)

Возврат ndarray с использованием ключевого аргумента ‘box’:

>>> pd.to_timedelta(np.arange(5), box=False)
array([0, 1, 2, 3, 4], dtype='timedelta64[ns]')