force_tz: Replace time zone to create new date-time
Description
force_tz returns a the date-time that has the same clock time as x in the new
time zone.
Although the new date-time has the same clock time (e.g. the
same values in the year, month, days, etc. elements) it is a
different moment of time than the input date-time. force_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
force_tz(time, tzone = "")
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 force_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.