pandas.tseries.offsets.YearBegin#

class pandas.tseries.offsets.YearBegin#

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

YearBegin 转到下一个日期,该日期是年度的开始。

属性

n

(int, 默认 1) 表示的年数。

normalize

(bool, 默认 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')

属性

基础

返回调用偏移对象的一个副本,其中 n=1 且所有其他属性相同。

freqstr

返回一个表示频率的字符串。

kwds

返回一个包含偏移额外参数的字典。

月份

n

名称

返回表示基本频率的字符串。

纳秒

返回一个整数,表示固定频率的总纳秒数。

normalize

rule_code

返回表示基本频率的字符串。

方法

复制()

返回频率的副本。

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)

返回布尔值,判断一个时间戳是否发生在年初。

回滚(dt)

如果不在偏移上,则将提供的日期向后滚动到下一个偏移。

rollforward(dt)

如果不在偏移上,则将提供的日期向前滚动到下一个偏移。