iso-year-week-day-setters {clock}

Setters: iso-year-week-day

Description

These are iso-year-week-day methods for the setter generics.

• set_year() sets the ISO year.

• set_week() sets the ISO week of the year. Valid values are in the range of ⁠[1, 53]⁠.

• set_day() sets the day of the week. Valid values are in the range of ⁠[1, 7]⁠, with 1 = Monday, and 7 = Sunday.

• There are sub-daily setters for setting more precise components.

Usage

## S3 method for class 'clock_iso_year_week_day'
set_year(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_week(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_day(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_hour(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_minute(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_second(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_millisecond(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_microsecond(x, value, ...)

## S3 method for class 'clock_iso_year_week_day'
set_nanosecond(x, value, ...)

Arguments

x

⁠[clock_iso_year_week_day]⁠

A iso-year-week-day vector.

value

⁠[integer / "last"]⁠

The value to set the component to.

For set_week(), this can also be "last" to adjust to the last week of the current ISO year.

...

These dots are for future extensions and must be empty.

Value

x with the component set.

Examples

# Year precision vector
x <- iso_year_week_day(2019:2023)

# Promote to week precision by setting the week
# (Note that some ISO weeks have 52 weeks, and others have 53)
x <- set_week(x, "last")
x

# Set to an invalid week
invalid <- set_week(x, 53)
invalid

# Here are the invalid ones (they only have 52 weeks)
invalid[invalid_detect(invalid)]

# Resolve the invalid dates by choosing the previous/next valid moment
invalid_resolve(invalid, invalid = "previous")
invalid_resolve(invalid, invalid = "next")