RcppCCTZ (version 0.2.3)

toTz: Shift datetime object from one timezone to another

Description

Change from one given timezone to another.

Usage

toTz(dt, tzfrom, tzto, verbose = FALSE)

Arguments

dt

A Datetime object specifying when the difference is to be computed.

tzfrom

The first time zone as a character vector.

tzto

The second time zone as a character vector.

verbose

A boolean toggle indicating whether more verbose operations are desired, default is FALSE.

Value

A Datetime object with the given (civil time) determined by the incoming object (and its timezone) shifted to the target timezone.

Details

Time zone offsets vary by date, and this helper function converts a Datetime object from one given timezone to another.

Examples

Run this code
# NOT RUN {
toTz(Sys.time(), "America/New_York", "Europe/London")
# this redoes the 'Armstrong on the moon in NYC and Sydney' example
# note that the default print method will print the return object in _your local time_
toTz(ISOdatetime(1969,7,20,22,56,0,tz="UTC"), "America/New_York", "Australia/Sydney", verbose=TRUE)
# whereas explicitly formating for Sydney time does the right thing
format(toTz(ISOdatetime(1969,7,20,22,56,0,tz="UTC"), 
            "America/New_York", "Australia/Sydney", verbose=TRUE), 
       tz="Australia/Sydney")
# }

Run the code above in your browser using DataCamp Workspace