datetimeoffset {datetimeoffset}

Datetime object with optional UTC offsets and/or timezones

Description

datetimeoffset() creates a datetime with possible UTC offset object. It can be used to represent datetimes with possible UTC offsets (without necessarily any knowledge of the time zone).

Usage

datetimeoffset(
  year = NA_integer_,
  month = NA_integer_,
  day = NA_integer_,
  hour = NA_integer_,
  minute = NA_integer_,
  second = NA_integer_,
  nanosecond = NA_integer_,
  subsecond_digits = NA_integer_,
  hour_offset = NA_integer_,
  minute_offset = NA_integer_,
  tz = NA_character_
)

Arguments

year

Year (integer, optional)

month

Month (integer, optional)

day

Day (integer, optional)

hour

Hour (integer, optional)

minute

Minute (integer, optional)

second

Second (integer, optional)

nanosecond

Nanosecond (integer, optional)

subsecond_digits

Number of digits used by fractional seconds (integer, optional)

hour_offset

UTC offset in hours (integer, optional)

minute_offset

UTC offset in minutes (integer, optional). Will be coerced to a non-negative value.

tz

Time zone (character, optional)

Value

A vctrs record with class datetimeoffset.

Examples

  datetimeoffset(2020)
  datetimeoffset(2020, 5)
  datetimeoffset(2020, 5, 15)
  datetimeoffset(2020, 5, 15, 8)
  datetimeoffset(2020, 5, 15, 8, 23)
  datetimeoffset(2020, 5, 15, 8, 23, 16) # local time with unknown timezone
  if ("US/Pacific" %in% OlsonNames())
    datetimeoffset(2020, 5, 15, 8, 23, 16, tz = "US/Pacific")
  datetimeoffset(2020, 5, 15, 8, 23, 16, tz = "GMT")
  datetimeoffset(2020, 5, 15, 8, 23, 16, hour_offset = -7)
  datetimeoffset(2020, 5, 15, 8, 23, 16, hour_offset = -7, minute_offset = 30)