ISOdatetime: Construct Date-time Objects

Description

ISOdate and ISOdatetime construct date-time objects from numeric representations. Sys.time returns current time.

Usage

ISOdatetime(
  year,
  month,
  day,
  hour,
  min,
  sec,
  tz = "",
  lenient = FALSE,
  locale = NULL
)

ISOdate(
  year,
  month,
  day,
  hour = 0L,
  min = 0L,
  sec = 0L,
  tz = "",
  lenient = FALSE,
  locale = NULL
)

Sys.time()

Arguments

year, month, day, hour, min, sec

numeric vectors

tz

NULL or '' for the default time zone (see stri_timezone_get) or a single string with a timezone identifier, see stri_timezone_list

lenient

single logical value; should date/time parsing be lenient?

locale

NULL or '' for the default locale (see stri_locale_get) or a single string with a locale identifier, see stri_locale_list

Value

These functions return an object of class POSIXxt, which extends upon POSIXct, strptime.

You might wish to consider calling as.Date on the result yielded by ISOdate.

No attributes are preserved (because they are too many).

Differences from Base R

Replacements for base ISOdatetime and ISOdate implemented with stri_datetime_create.

  • ISOdate does not treat dates as being at midnight by default [fixed here]

Author(s)

Marek Gagolewski

See Also

The official online manual of stringx at https://stringx.gagolewski.com/

Related function(s): strptime

Examples

ISOdate(1970, 1, 1)
## [1] "1970-01-01T00:00:00+1000"
ISOdatetime(1970, 1, 1, 12, 0, 0)
## [1] "1970-01-01T12:00:00+1000"