pandas.Timedelta#

класс pandas.Timedelta(value= object>, unit=None, **kwargs)#

Представляет длительность, разницу между двумя датами или временами.

Timedelta — это эквивалент python-объекта datetime.timedelta и взаимозаменяем с ним в большинстве случаев.

Параметры:

значениеTimedelta, timedelta, np.timedelta64, str или int

единицаstr, по умолчанию 'ns'

Обозначить единицу измерения входных данных, если входные данные являются целым числом.

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

‘W’, или ‘D’
‘days’, или ‘day’
'hours', 'hour', 'hr' или 'h'
‘minutes’, ‘minute’, ‘min’, или ‘m’
‘seconds’, ‘second’, ‘sec’, или ‘s’
'milliseconds', 'millisecond', 'millis', 'milli' или 'ms'
'microseconds', 'microsecond', 'micros', 'micro' или 'us'
'nanoseconds', 'nanosecond', 'nanos', 'nano', или 'ns'.

Устарело с версии 2.2.0: Значения H, T, S, L, U, и N устарели в пользу значений h, min, s, мс, нас, и нс.

**kwargs

Доступные kwargs: {days, seconds, microseconds, milliseconds, minutes, hours, weeks}. Значения для создания совместимы с datetime.timedelta. Целые и вещественные числа NumPy будут приведены к целым и вещественным числам Python.

Примечания

Конструктор может принимать либо оба значения value и unit, либо kwargs, как указано выше. Один из них должен использоваться при инициализации

The .value атрибут всегда в наносекундах.

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

Примеры

Здесь мы инициализируем объект Timedelta как значением, так и единицей измерения

>>> td = pd.Timedelta(1, "d")
>>> td
Timedelta('1 days 00:00:00')

Здесь мы инициализируем объект Timedelta с kwargs

>>> td2 = pd.Timedelta(days=1)
>>> td2
Timedelta('1 days 00:00:00')

Мы видим, что в любом случае получаем тот же результат

Атрибуты

`asm8`	Вернуть скалярное представление массива numpy timedelta64.
`components`	Возвращает именованный кортеж, подобный компонентам.
`days`	Возвращает дни timedelta.
`max`
`microseconds`
`min`
`nanoseconds`	Возвращает количество наносекунд (n), где 0 <= n < 1 микросекунда.
`resolution`
`resolution_string`	Возвращает строку, представляющую наименьшее разрешение временного интервала.
`seconds`	Возвращает общее количество часов, минут и секунд timedelta в секундах.
`unit`
`value`

Методы

`as_unit`(unit[, round_ok])	Преобразовать базовое представление int64 в заданную единицу измерения.
`ceil`(freq)	Вернуть новый Timedelta, округленный до этого разрешения.
`floor`(freq)	Вернуть новый Timedelta, округленный вниз до этого разрешения.
`isoformat`()	Форматировать Timedelta как длительность ISO 8601.
`round`(freq)	Округлить Timedelta до указанной точности.
`to_numpy`([dtype, copy])	Преобразовать Timedelta в NumPy timedelta64.
`to_pytimedelta`()	Преобразовать объект pandas Timedelta в python `datetime.timedelta` объект.
`to_timedelta64`()	Возвращает объект numpy.timedelta64 с точностью 'ns'.
`total_seconds`()	Общее количество секунд в продолжительности.
`view`(dtype)	Совместимость представления массива.