pandas.tseries.offsets.YearEnd

classpandas.tseries.offsets.YearEnd

DateOffset приращений между датами окончания календарного года.

YearEnd переходит к следующей дате, которая является концом года.

Параметры:

n:int, по умолчанию 1

Количество лет.

normalize:bool, по умолчанию False

Нормализовать даты начала/окончания до полуночи перед генерацией диапазона дат.

month:int, по умолчанию 12

Конкретное целое число для месяца года.

См. также

DateOffset

Стандартный тип приращения даты.

Примеры

>>> ts = pd.Timestamp(2022, 1, 1)
>>> ts + pd.offsets.YearEnd()
Timestamp('2022-12-31 00:00:00')

>>> ts = pd.Timestamp(2022, 12, 31)
>>> ts + pd.offsets.YearEnd()
Timestamp('2023-12-31 00:00:00')

>>> ts = pd.Timestamp(2022, 1, 1)
>>> ts + pd.offsets.YearEnd(month=2)
Timestamp('2022-02-28 00:00:00')

Если нужно получить конец текущего года:

>>> ts = pd.Timestamp(2022, 12, 31)
>>> pd.offsets.YearEnd().rollforward(ts)
Timestamp('2022-12-31 00:00:00')

Атрибуты

base	Возвращает копию объекта смещения вызывающего объекта с n=1 и всеми другими атрибутами равными.
freqstr	Возвращает строку, представляющую частоту.
kwds	Возвращает словарь дополнительных параметров для смещения.
month
n
name	Возвращает строку, представляющую базовую частоту.
nanos
normalize
rule_code

Методы

copy()	Возвращает копию частоты.
is_anchored()	(УСТАРЕЛО) Возвращает булево значение, указывает ли частота единичную частоту (n=1).
is_month_end(ts)	Возвращает булево значение, указывает ли временная метка конец месяца.
is_month_start(ts)	Возвращает булево значение, указывает ли временная метка начало месяца.
is_on_offset(dt)	Возвращает булево значение, указывает ли временная метка пересечение с этой частотой.
is_quarter_end(ts)	Возвращает булево значение, указывает ли временная метка конец квартала.
is_quarter_start(ts)	Возвращает булево значение, указывает ли временная метка начало квартала.
is_year_end(ts)	Возвращает булево значение, указывает ли временная метка конец года.
is_year_start(ts)	Возвращает булево значение, указывает ли временная метка начало года.
rollback(dt)	Перемещает заданную дату назад до следующего смещения только если она не на смещении.
rollforward(dt)	Перемещает заданную дату вперед до следующего смещения только если она не на смещении.