pandas.tseries.offsets.WeekOfMonth#

class pandas.tseries.offsets.WeekOfMonth#

Describes monthly dates like “the Tuesday of the 2nd week of each month”.

This offset allows for generating or adjusting dates by specifying a particular week and weekday within a month. The week is zero-indexed, where 0 corresponds to the first week of the month, and weekday follows a Monday=0 convention.

Attributes

n

Return the count of the number of periods.

normalize

Return boolean whether the frequency can align with midnight.

week

Return the week of the month on which this offset applies.

weekday

Return the day of the week on which this offset applies.

See also

offsets.Week

Describes weekly frequency adjustments.

offsets.MonthEnd

Describes month-end frequency adjustments.

date_range

Generates a range of dates based on a specific frequency.

Examples

>>> ts = pd.Timestamp(2022, 1, 1)
>>> ts + pd.offsets.WeekOfMonth()
Timestamp('2022-01-03 00:00:00')

Attributes

base

Returns a copy of the calling offset object with n=1 and all other attributes equal.

freqstr

Return a string representing the frequency.

kwds

Return a dict of extra parameters for the offset.

n

Return the count of the number of periods.

name

Return a string representing the base frequency.

nanos

Returns an integer of the total number of nanoseconds for fixed frequencies.

normalize

Return boolean whether the frequency can align with midnight.

rule_code

Return a string representing the base frequency.

week

Return the week of the month on which this offset applies.

weekday

Return the day of the week on which this offset applies.

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.