pandas.tseries.offsets.YearEnd

class pandas.tseries.offsets.YearEnd(n=1, normalize=False, month=None)

DateOffset 在日历年度结束日期之间进行递增。

YearEnd 会移动到下一个是该年最后一天的时间点。

参数:

nint, default 1

代表的年数。

normalizebool，默认为 False

在生成日期范围之前将 start/end 日期规范化为午夜。

monthint, 默认 12

指定一年的月份的整数。

另请参阅

DateOffset

Standard kind of date increment.

示例

>>> 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	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.
month	返回此偏移量适用的月份。
n	Return the count of the number of periods.
name	Return a string representing the base frequency.
nanos	Returns an integer of the total number of nanoseconds for fixed frequencies.
normalize	Return boolean whether the frequency can align with midnight.
rule_code	Return a string representing the base frequency.

Methods

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