Coerce and Format to Year-Isoweek Strings

Source: R/format.R

Coerce and Format to Year-Isoweek Strings

format_yw(x, w = NULL, format = "%Y-W%V")

Arguments

x, w

Two integer (vectors). w is optional and the interpretation of x will depend on whether w is supplied or not:

  • if only x is supplied, x will be passed to as_date_yw() (e.g. x = 201604 means 4th isoweek of 2016)

  • if x and w are supplied, x is interpreted as year and w as week.
format

A format that uses a subset of the same placeholders as base::strptime():

%YYear with century (the full year)
%yYear without century (the last two digits of the year)
%mMonth as a decimal numbers (01-12)
%BFull month name
%bAbbreviated month name
%VWeek of the year as decimal number (01-53) as defined in ISO8601

Not all placeholders are supported for all date_xx subclasses. Literal "%" can be escaped with "%%" (as in base::sprintf()).

Value

a character vector

Formatting shorthands

Format shorthand functions in the form of format_y*_[preset]() directly apply formatting presets to anything that can be coerced to a date_xx. This is notably handy as they can be used as a labeling function for ggplot2 axes (see vignette("dint"))

See also

format.date_yw()

Other coerce and format functions: format_ym(), format_yq()

Examples

format_yw(2015, 5)
#> [1] "2015-W05"
format_yw(201505, format = "%Y.%V")
#> [1] "2015.05"
format_yw(as_date_yw(201505), format = "%y.%V")
#> [1] "15.05"