R: Replace time zone to create new date-time

force_tz {lubridate} | R Documentation

## 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.

### Value

a POSIXct object in the updated time zone

### See Also

`with_tz`

### Examples

    x <- as.POSIXct("2009-08-07 00:00:01", tz = "America/New_York")
    force_tz(x, "GMT")

[Package lubridate version 1.6.0 Index]