pandas.to_timedelta#

pandas.to_timedelta(arg, единица=None, ошибки='raise')[источник]#

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

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

Параметры:
argstr, timedelta, list-like или Series

Данные для преобразования в timedelta.

Изменено в версии 2.0: Строки с единицами ‘M’, ‘Y’ и ‘y’ не представляют однозначные значения timedelta и вызовут исключение.

единицаstr, optional

Обозначает единицу измерения аргумента для числовых arg. По умолчанию "ns".

Возможные значения:

  • ‘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’

Не должно быть указано, когда arg содержит строки и errors="raise".

Устарело с версии 2.2.0: Единицы 'H', 'T', 'S', 'L', 'U' и 'N' устарели и будут удалены в будущей версии. Пожалуйста, используйте 'h', 'min', 's', 'ms', 'us' и 'ns' вместо 'H', 'T', 'S', 'L', 'U' и 'N'.

ошибки{‘ignore’, ‘raise’, ‘coerce’}, по умолчанию ‘raise’

  • Если 'raise', то недопустимый разбор вызовет исключение.

  • Если 'coerce', то некорректный разбор будет установлен как NaT.

  • Если 'ignore', то недопустимый разбор вернёт входные данные.

Возвращает:
timedelta

Если парсинг прошёл успешно. Тип возвращаемого значения зависит от ввода:

  • списокоподобный: TimedeltaIndex с типом данных timedelta64

  • Series: Series типа timedelta64

  • скаляр: Timedelta

Смотрите также

DataFrame.astype

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

to_datetime

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

convert_dtypes

Преобразовать dtypes.

Примечания

Если точность выше наносекунд, точность длительности обрезается до наносекунд для строковых входных данных.

Примеры

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

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

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

Преобразование чисел путем указания единица именованный аргумент:

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