Stable lifecycle

Create or coerce using yearquarter().

yearquarter(x)

is_yearquarter(x)

Arguments

x

Other object.

Value

year-quarter (yearquarter) objects.

Display

Use format() to display yearweek, yearmonth, and yearquarter objects in required formats. Please see strptime() details for supported conversion specifications.

See also

Other index functions: yearmonth(), yearweek()

Examples

# coerce POSIXct/Dates to yearquarter x <- seq(as.Date("2016-01-01"), as.Date("2016-12-31"), by = "1 quarter") yearquarter(x)
#> <yearquarter[4]> #> [1] "2016 Q1" "2016 Q2" "2016 Q3" "2016 Q4"
# parse characters yearquarter(c("2018 Q1", "2018 Qtr1", "2018 Quarter 1"))
#> <yearquarter[3]> #> [1] "2018 Q1" "2018 Q1" "2018 Q1"
# creat an empty yearquarter container yearquarter()
#> <yearquarter[0]>
# seq() and arithmetic qtr <- yearquarter("2017 Q1") seq(qtr, length.out = 10, by = 1) # by 1 quarter
#> <yearquarter[10]> #> [1] "2017 Q1" "2017 Q2" "2017 Q3" "2017 Q4" "2018 Q1" "2018 Q2" "2018 Q3" #> [8] "2018 Q4" "2019 Q1" "2019 Q2"
qtr + 0:9
#> <yearquarter[10]> #> [1] "2017 Q1" "2017 Q2" "2017 Q3" "2017 Q4" "2018 Q1" "2018 Q2" "2018 Q3" #> [8] "2018 Q4" "2019 Q1" "2019 Q2"
# display formats format(qtr, format = "%y Qtr%q")
#> [1] "17 Qtr1"
# units since 1970 Q1 as.double(yearquarter("1969 Q1") + 0:8)
#> [1] -4 -3 -2 -1 0 1 2 3 4