pandas.to_timedelta

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

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

Параметры:

arg : строка, timedelta, список, кортеж, одномерный массив или Series unit : единица измерения аргумента (D, h, m, s, ms, us, ns) обозначают единицу, которая является целым/вещественным числом box : boolean, по умолчанию True Если True, возвращает Timedelta/TimedeltaIndex результатов если False, возвращает np.timedelta64 или массив значений типа timedelta64[ns] errors : {‘ignore’, ‘raise’, ‘coerce’}, по умолчанию ‘raise’ Если ‘raise’, некорректный разбор вызовет исключение Если ‘coerce’, некорректный разбор будет установлен как NaT Если ‘ignore’, некорректный разбор вернёт входные данные

Возвращает:

ret : timedelta64/массивы timedelta64, если разбор выполнен успешно

См. также

pandas.DataFrame.astype

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

pandas.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)