Объект DateOffset в Pandas — это инструмент, используемый для выполнения смещений времени при обработке данных даты и времени.
Ниже приведены некоторые ключевые особенности и варианты использования DateOffset:
Базовые понятия
Объект DateOffset похож на Timedelta, но он следует правилам даты и времени, основанным на календаре, а не выполняет напрямую арифметические вычисления временного характера. Это означает, что DateOffset учитывает фактические календарные дни. Например, при работе с датами, пересекающими месяцы или годы, он правильно вычисляет разницу в днях, тогда как Timedelta просто добавляет указанное количество дней, не учитывая изменения в месяцах и годах.
Использование
DateOffset может выполнять операции смещения даты с помощью арифметических операторов (таких как +) или метода apply.
Например, вы можете использовать DateOffset так, чтобы добавить месяцы или часы:
Примеры
ts + DateOffset(months=3) # Добавить три месяца
ts + DateOffset(hours=2) # Добавить два часа
Если параметры не указаны, DateOffset() по умолчанию добавляет один календарный день:
ts + DateOffset() # 默认增加一天
Поддерживаемые параметры
DateOffset поддерживает множество параметров, позволяя задавать единицы времени для добавления или замены, такие как годы, месяцы, недели, дни, часы, минуты, секунды и т. д. Эти параметры могут добавляться к значению смещения (например, годы, месяцы, недели, дни, часы, минуты, секунды и т. д.) или заменять значение смещения (например, год, месяц, день, день недели, час, минута, секунда и т. д.).
Специальные методы
DateOffset также предоставляет методы rollforward() и rollback(), которые используются для сдвига даты вперед или назад к ближайшей допустимой дате. Например, если вы используете смещение на рабочий день (BDay), оно пропустит выходные и сразу перейдет к следующему рабочему дню.
Примеры
two_business_days = 2 * pd.offsets.BDay()
friday + two_business_days # Добавить два рабочих дня, пропуская выходные
Строки частоты
DateOffset поддерживает строки частоты или псевдонимы смещений, которые можно передать в качестве параметра freq. Эти строки частоты представляют объекты DateOffset и их подклассы и определяют частоту индексов datetime.
DateOffset — очень полезный инструмент в Pandas для обработки данных временных рядов, поскольку он делает операции смещения даты и времени более согласованными с фактическими календарными правилами.
Общие функции
Конструктор DateOffset
| Класс/Метод | Описание |
|---|---|
pd.DateOffset(**kwargs) |
Создайте объект DateOffset, поддерживающий пользовательские смещения времени. |
Распространённые подклассы DateOffset
| Класс | Описание |
|---|---|
pd.offsets.Day() |
Представляет смещение в днях. |
pd.offsets.BDay() |
Представляет смещение в рабочих днях (исключая выходные). |
pd.offsets.Hour() |
Представляет смещение в часах. |
pd.offsets.Minute() |
Представляет смещение в минутах. |
pd.offsets.Second() |
Представляет смещение в секундах. |
pd.offsets.Milli() |
Представляет смещение в миллисекундах. |
pd.offsets.Micro() |
Представляет смещение в микросекундах. |
pd.offsets.MonthEnd() |
Представляет смещение на конец месяца. |
pd.offsets.MonthBegin() |
Представляет смещение на начало месяца. |
pd.offsets.YearEnd() |
Представляет смещение на конец года. |
pd.offsets.YearBegin() |
Представляет смещение начала года. |
pd.offsets.QuarterEnd() |
Представляет смещение конца квартала. |
pd.offsets.QuarterBegin() |
Представляет смещение начала квартала. |
pd.offsets.Week() |
Представляет смещение в неделях. |
pd.offsets.WeekOfMonth() |
Представляет смещение на n-ю неделю месяца. |
Атрибуты DateOffset
| Attribute | Описание |
|---|---|
DateOffset.name |
Возвращает имя DateOffset. |
DateOffset.n |
Возвращает или задаёт количество смещений. |
DateOffset.normalize |
Возвращает или задаёт, нормализовать ли время к полуночи. |
Методы DateOffset
| Метод | Описание |
|---|---|
DateOffset.apply(other) |
Применить смещение к другому объекту datetime. |
DateOffset.rollforward(other) |
Переместить дату вперёд к следующему смещению. |
DateOffset.rollback(other) |
Откатите дату назад к предыдущему смещению. |
DateOffset.is_anchored() |
Проверьте, является ли смещение привязанным (т. е. имеет ли оно фиксированную частоту). |
DateOffset.onOffset(date) |
Проверьте, выровнена ли дата со смещением. |
Примеры
Примеры
from pandas.tseries.offsets import Day, BDay, MonthEnd
# Создать DateOffset
offset = Day(3)
print(offset) # Вывод <3 * Days>
# Применить DateOffset
date = pd.Timestamp('2023-01-01')
new_date = date + offset
print(new_date) # Вывод 2023-01-04
# Использовать общий подкласс
bday_offset = BDay(2)
new_bdate = date + bday_offset
print(new_bdate) # Вывод 2023-01-05 (пропуск выходных)
# Смещение на конец месяца
month_end_offset = MonthEnd()
new_month_end = date + month_end_offset
print(new_month_end) # Вывод 2023-01-31
Подробное описание параметров
pd.DateOffset()
| Параметр | Описание |
|---|---|
years |
Количество лет смещения. |
months |
Количество месяцев смещения. |
weeks |
Количество недель смещения. |
days |
Смещение в днях. |
hours |
Смещение в часах. |
minutes |
Смещение в минутах. |
seconds |
Смещение в секундах. |
milliseconds |
Смещение в миллисекундах. |
microseconds |
Смещение в микросекундах. |
nanoseconds |
Смещение в наносекундах. |
pd.offsets.BDay()
| Параметр | Описание |
|---|---|
n |
Количество смещений, по умолчанию — 1. |
normalize |
Нормализовать ли время к полуночи, по умолчанию —False。 |
pd.offsets.MonthEnd()
| Параметр | Описание |
|---|---|
n |
Количество смещений, по умолчанию — 1. |
normalize |
Нормализовать ли время к полуночи, по умолчанию —False。 |
Для более подробной информации обратитесь кофициальной документации Pandas。
Другие расширения