with_tz returns a date-time as it would appear in a different time zone.
The actual moment of time measured does not change, just the time zone it is
measured in. with_tz defaults to the Universal Coordinated time zone (UTC)
when an unrecognized time zone is inputted. See Sys.timezone()
for more information on how R recognizes time zones.
Usage
with_tz(time, tzone = "", ...)
# S3 method for default
with_tz(time, tzone = "", ...)
Value
a POSIXct object in the updated time zone
Arguments
time
a POSIXct, POSIXlt, Date, chron date-time object or a data.frame
object. When a data.frame all POSIXt elements of a data.frame are processed
with with_tz() and new data.frame is returned.
tzone
a character string containing the time zone to convert to. R
must recognize the name contained in the string as a time zone on your
system.