R: Convert to a zoned-time from a sys-time

as-zoned-time-sys-time {clock} | R Documentation

## Convert to a zoned-time from a sys-time

### Description

This is a sys-time method for the `as_zoned_time()` generic.

Converting to a zoned-time from a sys-time retains the underlying duration, but changes the printed time, depending on the `zone` that you choose. Remember that sys-times are interpreted as UTC.

If you want to retain the printed time, try converting to a zoned-time from a naive-time, which is a time point with a yet-to-be-determined time zone.

### Usage

    ## S3 method for class 'clock_sys_time'
    as_zoned_time(x, zone, ...)

### Arguments

`x` | `[clock_sys_time]` A sys-time to convert to a zoned-time.
`zone` | `[character(1)]` The zone to convert to.
`...` | These dots are for future extensions and must be empty.

### Value

A zoned-time vector.

### Examples

    x <- as_sys_time(year_month_day(2019, 02, 01, 02, 30, 00))
    x

    # Since sys-time is interpreted as UTC, converting to a zoned-time with
    # a zone of UTC retains the printed time
    x_utc <- as_zoned_time(x, "UTC")
    x_utc

    # Converting to a different zone results in a different printed time,
    # which corresponds to the exact same point in time, just in a different
    # part of the work
    x_ny <- as_zoned_time(x, "America/New_York")
    x_ny

[Package clock version 0.6.0 Index]