fred_recession_dates: NBER US business-cycle reference dates

Description

Returns the NBER Business Cycle Dating Committee's reference dates for US business-cycle peaks and troughs since 1857. With flag = NULL (default), returns one row per recession (peak, trough, duration). Pass a vector of observation dates as flag to get back a data frame indicating whether each observation falls within a recession.

Usage

fred_recession_dates(from = NULL, to = NULL, flag = NULL)

Value

A fred_tbl. Default columns: peak, trough, duration_months. With flag: date, in_recession.

Arguments

from: Optional character or Date. Filter to recessions whose peak is on or after this date.
to: Optional character or Date. Filter to recessions whose trough is on or before this date.
flag: Optional Date vector. If supplied, returns a data frame data.frame(date, in_recession) indicating whether each date falls within an NBER recession. Useful as a regression covariate or for plotting.

Details

Source: NBER Business Cycle Dating Committee (https://www.nber.org/research/data/us-business-cycle-expansions-and-contractions). Dates are ISO month-start (peak = first month of recession, trough = last month of recession).

Examples

Run this code

# All recessions since 1857
fred_recession_dates()

# Modern era only
fred_recession_dates(from = "1948-01-01")

# Flag a vector of dates
fred_recession_dates(flag = seq(as.Date("2007-01-01"), as.Date("2010-12-01"),
                                by = "month"))