datetimeoffset (version 1.0.0)

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_
)

Value

A vctrs record with class datetimeoffset.

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)

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)