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.

Parameters:
nint, default 1

The number of months represented.

normalizebool, default False

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

weekint {0, 1, 2, 3, …}, default 0

A specific integer for the week of the month. e.g. 0 is 1st week of month, 1 is the 2nd week, etc.

weekdayint {0, 1, …, 6}, default 0

A specific integer for the day of the week.

  • 0 is Monday

  • 1 is Tuesday

  • 2 is Wednesday

  • 3 is Thursday

  • 4 is Friday

  • 5 is Saturday

  • 6 is Sunday.

Attributes

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')
On this page