Skip to contents

is_datetimeoffset() tests whether a datetime object is of the "datetimeoffset" class. NA_datetimeoffset_ provides a "missing" "datetimeoffset" object. datetimeoffset_now() returns the current time in the corresponding time zone(s).

Usage

is_datetimeoffset(x)

NA_datetimeoffset_

datetimeoffset_now(tz = Sys.timezone())

Format

An object of class datetimeoffset (inherits from vctrs_rcrd, vctrs_vctr) of length 1.

Arguments

x

An object to be tested

tz

Time zone(s)

Value

is_datetimeoffset() returns a logical vector. datetimeoffset_now() returns a datetimeoffset() vector.

Examples

  is_datetimeoffset(as_datetimeoffset(Sys.time()))
#> [1] TRUE
  is_datetimeoffset(Sys.time())
#> [1] FALSE

  is.na(NA_datetimeoffset_)
#> [1] TRUE
  is.na(as_datetimeoffset(""))
#> [1] TRUE

  if (all(c("America/Los_Angeles", "America/New_York") %in% OlsonNames()))
    datetimeoffset_now(c("America/Los_Angeles", "America/New_York"))
#> <datetimeoffset[2]>
#> [1] 2025-03-24T09:52:31.478240649-07:00[America/Los_Angeles]
#> [2] 2025-03-24T12:52:31.478240649-04:00[America/New_York]