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 且所有其他属性相同。
返回一个表示频率的字符串。
返回一个包含偏移额外参数的字典。
返回表示基本频率的字符串。
返回一个整数,表示固定频率的总纳秒数。
返回表示基本频率的字符串。
方法
复制
()返回频率的副本。
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)如果不在偏移上,则将提供的日期向前滚动到下一个偏移。