pandas.Timedelta

classpandas.Timedelta(value=<object object>, unit=None, **kwargs)

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

Timedelta — это аналог datetime.timedelta в pandas и взаимозаменяем с ним в большинстве случаев.

Параметры:

value:Timedelta, timedelta, np.timedelta64, str, или int

unit: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, ms, us и ns.

**kwargs

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

Примечания

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

Атрибут .value всегда в ns.

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

Примеры

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

>>> 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	Возвращает компоненты, похожие на namedtuple.
days	Возвращает количество дней в timedelta.
max
microseconds
min
nanoseconds	Возвращает количество наносекунд (n), где 0 <= n < 1 микросекунда.
resolution
resolution_string	Возвращает строку, представляющую наименьшее разрешение timedelta.
seconds	Возвращает общее количество часов, минут и секунд timedelta в секундах.
unit
value

Методы

as_unit(unit[, round_ok])	Преобразовать базовое представление int64 в заданную единицу измерения.
ceil(freq)	Возвращает новый Timedelta, округленный до этого разрешения.
floor(freq)	Возвращает новый Timedelta, усеченный до этого разрешения.
isoformat()	Форматирует Timedelta как ISO 8601 Duration.
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)	Совместимость с представлением массива.