pandas.tseries.offsets.CustomBusinessMonthBegin

class pandas.tseries.offsets.CustomBusinessMonthBegin

DateOffset 的子类，表示自定义的营业月份。

月初日期之间的增量。

Parameters:

nint, 默认值 1

The number of months represented.

normalizebool，默认 False

在生成日期范围之前，将开始日期规范化为午夜。

weekmaskstr，默认值为 ‘Mon Tue Wed Thu Fri’

有效的业务日周掩码，传递给 numpy.busdaycalendar。

holidayslist

要从有效业务日集中排除的日期列表/数组，传递给 numpy.busdaycalendar。

日历np.busdaycalendar

要集成的日历。

offsettimedelta, default timedelta(0)

要应用的日期偏移量。

参见

DateOffset

标准的日期增量类型。

Examples

在下面的示例中，我们 sử dụng 默认参数。

>>> ts = pd.Timestamp(2022, 8, 5)
>>> ts + pd.offsets.CustomBusinessMonthBegin()
Timestamp('2022-09-01 00:00:00')

可以通过 weekmask 参数指定自定义营业月份开始。要将返回的 datetime 对象转换为其字符串表示形式，请在下一个示例中使用 strftime() 函数。

>>> import datetime as dt
>>> freq = pd.offsets.CustomBusinessMonthBegin(weekmask="Wed Thu")
>>> pd.date_range(dt.datetime(2022, 7, 10), dt.datetime(2022, 12, 18),
...               freq=freq).strftime('%a %d %b %Y %H:%M')
Index(['Wed 03 Aug 2022 00:00', 'Thu 01 Sep 2022 00:00',
       'Wed 05 Oct 2022 00:00', 'Wed 02 Nov 2022 00:00',
       'Thu 01 Dec 2022 00:00'],
       dtype='object')

使用 NumPy 的 business day calendar，您可以定义自定义假期。

>>> import datetime as dt
>>> bdc = np.busdaycalendar(holidays=['2022-08-01', '2022-09-30',
...                                   '2022-10-31', '2022-11-01'])
>>> freq = pd.offsets.CustomBusinessMonthBegin(calendar=bdc)
>>> pd.date_range(dt.datetime(2022, 7, 10), dt.datetime(2022, 11, 10), freq=freq)
DatetimeIndex(['2022-08-02', '2022-09-01', '2022-10-03', '2022-11-02'],
               dtype='datetime64[ns]', freq='CBMS')

Attributes

base	返回调用偏移量对象的副本，其中 n=1 且所有其他属性都相同。
calendar
cbday_roll	定义应用方法中调用的默认滚动函数。
freqstr	返回表示频率的字符串。
holidays
kwds	返回偏移量的额外参数字典。
m_offset
month_roll	定义应用方法中调用的默认滚动函数。
n
name	返回表示基本频率的字符串。
nanos
normalize
offset	Alias for self._offset.
rule_code
weekmask

Methods

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)	如果提供的日期不在偏移量上，则将其向前滚动到下一个偏移量。