pandas.tseries.offsets.YearBegin

class pandas.tseries.offsets.YearBegin

DateOffset 在日历年开始日期之间进行增量。

YearBegin 前进到下一个日历年开始的日期。

属性

n	Return the count of the number of periods.
normalize	Return boolean whether the frequency can align with midnight.
month	返回此偏移量适用的月份。

另请参阅

DateOffset

Standard kind of date increment.

示例

>>> ts = pd.Timestamp(2022, 12, 1)
>>> ts + pd.offsets.YearBegin()
Timestamp('2023-01-01 00:00:00')

>>> ts = pd.Timestamp(2023, 1, 1)
>>> ts + pd.offsets.YearBegin()
Timestamp('2024-01-01 00:00:00')

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

如果您想获取当前年份的开始

>>> ts = pd.Timestamp(2023, 1, 1)
>>> pd.offsets.YearBegin().rollback(ts)
Timestamp('2023-01-01 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.