phrase_datetime: Phrase date(time)s

In salim-b/salim: A Wild Mix of Functions Serving Various Purposes

Phrase date(time)s

Description

Formats date(time)s as strings according to the specified formats and locale, applying some typographic tweaks. A convenience wrapper around stringi::stri_datetime_format().

Usage

phrase_datetime(x, format = "date_long", locale = funky::config_val("locale"))

Arguments

x	Date(s) or datetime(s) to format. A date, datetime, factor or character vector.
format	Format string(s) defining how to phrase x. Possible values include "date_short", "date_medium", "date_long", "date_full", "time_short", "time_medium", "time_long" and "time_full". See stringi::stri_datetime_format() for details.
locale	NULL or '' for the default locale, or a single string with locale identifier; a non-Gregorian calendar may be specified by setting the @calendar=name keyword

Value

A character vector of the same length as x.

See Also

Other spoken language functions: add_definite_article_de(), decline_noun_de(), definite_article_de(), definite_article_de_declined(), n_ify(), rank_nr(), write_out_n()

Examples

salim::phrase_datetime("2020-02-20")

salim::phrase_datetime(x = as.POSIXct(0L),
                       format = c("date_full",
                                  "time_full"),
                       locale = "de-CH")

# note that character input is internally converted to a datetime using `as.POSIXct()` with the
# default `format` which ignores possible time components:
salim::phrase_datetime(x = "2020-02-20T13:13:13Z",
                       format = c("date_full",
                                  "time_full"))

# hence it's recommended to directly provide input as datetimes:
salim::phrase_datetime(x = clock::date_time_parse_RFC_3339("2020-02-20T13:13:13Z"),
                       format = c("date_full",
                                  "time_full"))

salim-b/salim documentation built on June 10, 2025, 9:28 p.m.