format_age_quarter: Create consistent, complete quarter (three month) age groups

In johnrbryant/demprep: Prepare Demographic Data

Description

Given a vector of age group labels, create a factor that contains levels for all ages between break_min and break_max. The labels may contain an open age group, ie an age group with no upper limit. Apart from the open age group, all the age groups have a width of one quarter (three months).

Usage

format_age_quarter(x, break_min = 0, break_max = 400, open_last = TRUE)

Arguments

x	A vector of age group labels.
break_min	An integer or NULL. Defaults to 0.
break_max	An integer or NULL. Defaults to 400.
open_last	Whether the final age group has no upper limit. Defaults to TRUE.

Details

Even when an age group between break_min and break_max is not included in x, factor_quarter still creates a level for it.

If break_min or break_max is set to NULL, rather than to a specific value, then format_age_year finds the narrowest range that accommodates the data.

If x contains NA, then the levels of the factor created by format_age_quarter also contain NA.

Value

A factor with the same length as x.

See Also

Other functions for creating age groups are

• format_age_year

• format_age_multi

• format_age_lifetab

• format_age_births

• format_age_custom

• format_age_month

date_to_age_quarter calculates ages from dates.

Examples

format_age_quarter(x = c(0, 21, 5))

format_age_quarter(x = c("10", "22", "500+"))

## specify highest age group
format_age_quarter(x = c("10", "22", "500+"),
                   break_max = 48)

## let lowest age group be determined by the data
format_age_quarter(x = c("10", "22", "500+"),
                   break_min = NULL,
                   break_max = 48)

## make final age group closed
format_age_quarter(x = c("10", "22"),
                   break_min = NULL,
                   break_max = 48,
                   open_last = FALSE)

johnrbryant/demprep documentation built on Dec. 31, 2021, 11:58 a.m.