Атрибут components

Атрибут components применяется к объекту Timedelta и возвращает именованный кортеж, содержащий разложение временного интервала на отдельные компоненты. В возвращаемом объекте доступны следующие поля: days, hours, minutes, seconds и microseconds. Этот атрибут удобен для получения человеко-читаемого представления временного промежутка.

Синтаксис

timedelta.components

Пример

Давайте создадим временной интервал и разложим его на компоненты:

import pandas as pd

td = pd.Timedelta(days=5, hours=3, minutes=25, seconds=10)
res = td.components
print(res)

Результат выполнения кода:

Components(days=5, hours=3, minutes=25, seconds=10, milliseconds=0, microseconds=0, nanoseconds=0)

Пример

Рассмотрим доступ к отдельным полям компонентов:

import pandas as pd

td = pd.Timedelta(days=2, hours=15, minutes=45)
comp = td.components
print(comp.days)
print(comp.hours)
print(comp.minutes)

Результат выполнения кода:

2
15
45

Пример

Атрибут components также работает с временными интервалами, созданными из строки:

import pandas as pd

td = pd.Timedelta('3 days 07:12:45.500')
res = td.components
print(res)

Результат выполнения кода:

Components(days=3, hours=7, minutes=12, seconds=45, milliseconds=500, microseconds=0, nanoseconds=0)

Пример

Разница между двумя моментами времени и её компоненты:

import pandas as pd

t1 = pd.Timestamp('2025-01-01 10:30:00')
t2 = pd.Timestamp('2025-01-05 18:45:20')
delta = t2 - t1
res = delta.components
print(res)

Результат выполнения кода:

Components(days=4, hours=8, minutes=15, seconds=20, milliseconds=0, microseconds=0, nanoseconds=0)

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

класс Timedelta,
который представляет временной интервал
атрибут days,
который возвращает количество дней в интервале
атрибут seconds,
который возвращает количество секунд в интервале
метод total_seconds,
который возвращает общее количество секунд в интервале