zoned-zone: Get or set the time zone

Description Usage Arguments Value Examples

Description

zoned_time_zone() gets the time zone.

zoned_time_set_zone() sets the time zone without changing the underlying instant. This means that the result will represent the equivalent time in the new time zone.

Usage

1
2
3

Arguments

x

[zoned_time / Date / POSIXt]

A zoned time to get or set the time zone of.

zone

[character(1)]

A valid time zone to switch to.

Value

zoned_time_zone() returns a string containing the time zone.

zoned_time_set_zone() returns x with an altered time zone attribute. The underlying instant is not changed.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
x <- year_month_day(2019, 1, 1)
x <- as_zoned_time(as_naive_time(x), "America/New_York")
x

zoned_time_zone(x)

# Equivalent UTC time
zoned_time_set_zone(x, "UTC")

# To force a new time zone with the same printed time,
# convert to a naive time that has no implied time zone,
# then convert back to a zoned time in the new time zone.
nt <- as_naive_time(x)
nt
as_zoned_time(nt, "UTC")

clock documentation built on April 23, 2021, 1:06 a.m.