pandas.tseries.offsets.SemiMonthEnd#

class pandas.tseries.offsets.SemiMonthEnd#

Two DateOffset’s per month repeating on the last day of the month & day_of_month.

This offset allows for flexibility in generating date ranges or adjusting dates to the end of a month or a specific day in the month, such as the 15th or the last day of the month. It is useful for financial or scheduling applications where events occur bi-monthly.

Attributes

n	(int, default 1) The number of months represented.
normalize	(bool, default False) Normalize start/end dates to midnight before generating date range.
day_of_month	(int, {1, 3,…,27}, default 15) A specific integer for the day of the month.

See also

tseries.offsets.SemiMonthBegin: Offset for semi-monthly frequencies, starting at the beginning of the month.
tseries.offsets.MonthEnd: Offset to the last calendar day of the month.
tseries.offsets.MonthBegin: Offset to the first calendar day of the month.

Examples

>>> ts = pd.Timestamp(2022, 1, 14)
>>> ts + pd.offsets.SemiMonthEnd()
Timestamp('2022-01-15 00:00:00')

>>> ts = pd.Timestamp(2022, 1, 15)
>>> ts + pd.offsets.SemiMonthEnd()
Timestamp('2022-01-31 00:00:00')

>>> ts = pd.Timestamp(2022, 1, 31)
>>> ts + pd.offsets.SemiMonthEnd()
Timestamp('2022-02-15 00:00:00')

If you want to get the result for the current month:

>>> ts = pd.Timestamp(2022, 1, 15)
>>> pd.offsets.SemiMonthEnd().rollforward(ts)
Timestamp('2022-01-15 00:00:00')

Attributes

`base`	Returns a copy of the calling offset object with n=1 and all other attributes equal.
`day_of_month`
`freqstr`	Return a string representing the frequency.
`kwds`	Return a dict of extra parameters for the offset.
`n`
`name`	Return a string representing the base frequency.
`nanos`	Returns a integer of the total number of nanoseconds for fixed frequencies.
`normalize`
`rule_code`

Methods

`copy`()	Return a copy of the frequency.
`is_month_end`(ts)	Return boolean whether a timestamp occurs on the month end.
`is_month_start`(ts)	Return boolean whether a timestamp occurs on the month start.
`is_on_offset`(dt)	Return boolean whether a timestamp intersects with this frequency.
`is_quarter_end`(ts)	Return boolean whether a timestamp occurs on the quarter end.
`is_quarter_start`(ts)	Return boolean whether a timestamp occurs on the quarter start.
`is_year_end`(ts)	Return boolean whether a timestamp occurs on the year end.
`is_year_start`(ts)	Return boolean whether a timestamp occurs on the year start.
`rollback`(dt)	Roll provided date backward to next offset only if not on offset.
`rollforward`(dt)	Roll provided date forward to next offset only if not on offset.