pandas.tseries.offsets.YearEnd#

class pandas.tseries.offsets.YearEnd#

DateOffset increments between calendar year end dates.

YearEnd goes to the next date which is the end of the year.

Parameters:

nint, default 1: The number of years represented.
normalizebool, default False: Normalize start/end dates to midnight before generating date range.
monthint, default 12: A specific integer for the month of the year.

See also

Examples

>>> 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')

If you want to get the end of the current year:

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

Attributes

`base`	Returns a copy of the calling offset object with n=1 and all other attributes equal.
`freqstr`	Return a string representing the frequency.
`kwds`	Return a dict of extra parameters for the offset.
`name`	Return a string representing the base frequency.

Methods

`copy`	Return a copy of the frequency.
`is_anchored`	Return boolean whether the frequency is a unit frequency (n=1).
`is_month_end`	Return boolean whether a timestamp occurs on the month end.
`is_month_start`	Return boolean whether a timestamp occurs on the month start.
`is_on_offset`	Return boolean whether a timestamp intersects with this frequency.
`is_quarter_end`	Return boolean whether a timestamp occurs on the quarter end.
`is_quarter_start`	Return boolean whether a timestamp occurs on the quarter start.
`is_year_end`	Return boolean whether a timestamp occurs on the year end.
`is_year_start`	Return boolean whether a timestamp occurs on the year start.
`rollback`	Roll provided date backward to next offset only if not on offset.
`rollforward`	Roll provided date forward to next offset only if not on offset.