Skip to main content
`Ctrl`+`K`

# pandas.tseries.offsets.QuarterBegin

class pandas.tseries.offsets.QuarterBegin

  DateOffset increments between Quarter start dates.

  startingMonth = 1 corresponds to dates like 1/01/2007, 4/01/2007, … startingMonth = 2 corresponds to dates like 2/01/2007, 5/01/2007, … startingMonth = 3 corresponds to dates like 3/01/2007, 6/01/2007, …

  Parameters:
    nint, default 1

      The number of quarters represented.

    normalizebool, default False

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

    startingMonthint, default 3

      A specific integer for the month of the year from which we start quarters.

  See also

  `DateOffset`

    Standard kind of date increment.

  Examples

      >>> ts = pd.Timestamp(2022, 1, 1)
      >>> ts + pd.offsets.QuarterBegin()
      Timestamp('2022-03-01 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` |
  `name` | Return a string representing the base frequency.
  `nanos` |
  `normalize` |
  `rule_code` |
  `startingMonth` |

  Methods

  `copy`() | Return a copy of the frequency.
  `is_anchored`() | Return boolean whether the frequency is a unit frequency (n=1).
  `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.