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’, ‘T’, ‘S’, ‘L’, ‘U’, или ‘N’

• ‘days’ или ‘day’

• ‘hours’, ‘hour’, ‘hr’, или ‘h’

• ‘minutes’, ‘minute’, ‘min’, или ‘m’

• ‘seconds’, ‘second’, или ‘sec’

• ‘milliseconds’, ‘millisecond’, ‘millis’, или ‘milli’

• ‘microseconds’, ‘microsecond’, ‘micros’, или ‘micro’

• ‘nanoseconds’, ‘nanosecond’, ‘nanos’, ‘nano’, или ‘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
delta	(УСТАРЕЛО) Возвращает продолжительность в наносекундах (нс) для внутренней совместимости.
freq	(УСТАРЕЛО) Свойство Freq.
is_populated	(УСТАРЕЛО) Свойство is_populated.
microseconds
nanoseconds	Возвращает количество наносекунд (n), где 0 <= n < 1 микросекунда.
resolution_string	Возвращает строку, представляющую наименьшее разрешение Timedelta.
seconds

value

Методы

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