Объект DateOffset в Pandas — это инструмент, используемый для выполнения смещений времени при обработке данных даты и времени.

Ниже приведены некоторые ключевые особенности и варианты использования DateOffset:

Базовые понятия

Объект DateOffset похож на Timedelta, но он следует правилам даты и времени, основанным на календаре, а не выполняет напрямую арифметические вычисления временного характера. Это означает, что DateOffset учитывает фактические календарные дни. Например, при работе с датами, пересекающими месяцы или годы, он правильно вычисляет разницу в днях, тогда как Timedelta просто добавляет указанное количество дней, не учитывая изменения в месяцах и годах.

Использование

DateOffset может выполнять операции смещения даты с помощью арифметических операторов (таких как +) или метода apply.

Например, вы можете использовать DateOffset так, чтобы добавить месяцы или часы:

Примеры

ts = pd.Timestamp('2017-01-01 09:10:11')
ts + DateOffset(months=3)  # Добавить три месяца
ts + DateOffset(hours=2)   # Добавить два часа

Если параметры не указаны, DateOffset() по умолчанию добавляет один календарный день:

ts + DateOffset()  # 默认增加一天

Поддерживаемые параметры

DateOffset поддерживает множество параметров, позволяя задавать единицы времени для добавления или замены, такие как годы, месяцы, недели, дни, часы, минуты, секунды и т. д. Эти параметры могут добавляться к значению смещения (например, годы, месяцы, недели, дни, часы, минуты, секунды и т. д.) или заменять значение смещения (например, год, месяц, день, день недели, час, минута, секунда и т. д.).

Специальные методы

DateOffset также предоставляет методы rollforward() и rollback(), которые используются для сдвига даты вперед или назад к ближайшей допустимой дате. Например, если вы используете смещение на рабочий день (BDay), оно пропустит выходные и сразу перейдет к следующему рабочему дню.

Примеры

friday = pd.Timestamp('2022-01-05')
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) Проверьте, выровнена ли дата со смещением.

Примеры

Примеры

import pandas as pd
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。

Другие расширения