Group calendar components — calendar

calendar_group() groups at a multiple of the specified precision. Grouping alters the value of a single component (i.e. the month component if grouping by month). Components that are more precise than the precision being grouped at are dropped altogether (i.e. the day component is dropped if grouping by month).

Each calendar has its own help page describing the grouping process in more detail:

Usage

calendar_group(x, precision, ..., n = 1L)

Arguments

x

[calendar]

A calendar vector.

precision

[character(1)]

A precision. Allowed precisions are dependent on the calendar used.

...

These dots are for future extensions and must be empty.

n

[positive integer(1)]

A single positive integer specifying a multiple of precision to use.

Value

x grouped at the specified precision.

Examples

# See the calendar specific help pages for more examples
x <- year_month_day(2019, c(1, 1, 2, 2, 3, 3, 4, 4), 1:8)
x
#> <year_month_day<day>[8]>
#> [1] "2019-01-01" "2019-01-02" "2019-02-03" "2019-02-04" "2019-03-05"
#> [6] "2019-03-06" "2019-04-07" "2019-04-08"

# Group by two months
calendar_group(x, "month", n = 2)
#> <year_month_day<month>[8]>
#> [1] "2019-01" "2019-01" "2019-01" "2019-01" "2019-03" "2019-03" "2019-03"
#> [8] "2019-03"

# Group by two days of the month
calendar_group(x, "day", n = 2)
#> <year_month_day<day>[8]>
#> [1] "2019-01-01" "2019-01-01" "2019-02-03" "2019-02-03" "2019-03-05"
#> [6] "2019-03-05" "2019-04-07" "2019-04-07"