as_duration: Convert to a duration

In clock: Date-Time Types and Tools

Convert to a duration

Description

You generally convert to a duration from either a sys-time or a naive-time. The precision of the input is retained in the returned duration.

To round an existing duration to another precision, see duration_floor().

Usage

as_duration(x, ...)

Arguments

x	⁠[object]⁠ An object to convert to a duration.
...	These dots are for future extensions and must be empty.

Value

A duration with the same precision as x.

Examples

x <- as_sys_time(year_month_day(2019, 01, 01))

# The number of days since 1970-01-01 UTC
as_duration(x)

x <- x + duration_seconds(1)
x

# The number of seconds since 1970-01-01 00:00:00 UTC
as_duration(x)

clock documentation built on Sept. 11, 2024, 8:39 p.m.