pandas.tseries.offsets.MonthBegin

class pandas.tseries.offsets.MonthBegin

DateOffset of one month at beginning.

MonthBegin goes to the next date which is a start of the month.

Parameters:

nint, default 1

The number of months represented.

normalizebool, default False

Normalize start/end dates to midnight before generating date range.

See also

DateOffset

Standard kind of date increment.

Examples

>>> ts = pd.Timestamp(2022, 11, 30)
>>> ts + pd.offsets.MonthBegin()
Timestamp('2022-12-01 00:00:00')

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

If you want to get the start of the current month:

>>> ts = pd.Timestamp(2022, 12, 1)
>>> pd.offsets.MonthBegin().rollback(ts)
Timestamp('2022-12-01 00:00:00')