weekday_factor: Convert a weekday to an ordered factor

In clock: Date-Time Types and Tools

Convert a weekday to an ordered factor

Description

weekday_factor() converts a weekday object to an ordered factor. This can be useful in combination with ggplot2, or for modeling.

Usage

weekday_factor(x, ..., labels = "en", abbreviate = TRUE, encoding = "western")

Arguments

x	⁠[weekday]⁠ A weekday vector.
...	These dots are for future extensions and must be empty.
labels	⁠[clock_labels / character(1)]⁠ Character representations of localized weekday names, month names, and AM/PM names. Either the language code as string (passed on to clock_labels_lookup()), or an object created by clock_labels().
abbreviate	⁠[logical(1)]⁠ If TRUE, the abbreviated weekday names from labels will be used. If FALSE, the full weekday names from labels will be used.
encoding	⁠[character(1)]⁠ One of: "western": Encode the weekdays as an ordered factor with levels from Sunday -> Saturday. "iso": Encode the weekdays as an ordered factor with levels from Monday -> Sunday.

Value

An ordered factor representing the weekdays.

Examples

x <- weekday(1:7)

# Default to Sunday -> Saturday
weekday_factor(x)

# ISO encoding is Monday -> Sunday
weekday_factor(x, encoding = "iso")

# With full names
weekday_factor(x, abbreviate = FALSE)

# Or a different language
weekday_factor(x, labels = "fr")

clock documentation built on Sept. 11, 2024, 8:39 p.m.