pandas.tseries.offsets.YearBegin

pandas.tseries.offsets类 。年开始

DateOffset 在日历年开始日期之间递增。

YearBegin 转到下一个日期，即年份的开始。

参数：

n整数，默认1

所代表的年数。

标准化布尔值，默认 False

在生成日期范围之前将开始/结束日期标准化为午夜。

月份int，默认 1

一年中月份的特定整数。

也可以看看

DateOffset

标准类型的日期增量。

例子

>>> 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	返回调用偏移对象的副本，其中 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)	仅当不在偏移时，将提供的日期向前滚动到下一个偏移。