as.interval: Change an object to an 'interval'.

Description Usage Arguments Details Value See Also Examples

View source: R/coercion.r

Description

as.interval changes difftime, Duration, Period and numeric class objects to intervals that begin at the specified date-time. Numeric objects are first coerced to timespans equal to the numeric value in seconds.

Usage

1

Arguments

x

a duration, difftime, period, or numeric object that describes the length of the interval

start

a POSIXt or Date object that describes when the interval begins

...

additional arguments to pass to as.interval

Details

as.interval can be used to create accurate transformations between Period objects, which measure time spans in variable length units, and Duration objects, which measure timespans as an exact number of seconds. A start date- time must be supplied to make the conversion. Lubridate uses this start date to look up how many seconds each variable length unit (e.g. month, year) lasted for during the time span described. See as.duration, as.period.

Value

an interval object

See Also

interval

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
diff <- make_difftime(days = 31) #difftime
as.interval(diff, ymd("2009-01-01"))
as.interval(diff, ymd("2009-02-01"))

dur <- duration(days = 31) #duration
as.interval(dur, ymd("2009-01-01"))
as.interval(dur, ymd("2009-02-01"))

per <- period(months = 1) #period
as.interval(per, ymd("2009-01-01"))
as.interval(per, ymd("2009-02-01"))

as.interval(3600, ymd("2009-01-01")) #numeric

Example output

Attaching package: 'lubridate'

The following object is masked from 'package:base':

    date

[1] 2009-01-01 UTC--2009-02-01 UTC
[1] 2009-02-01 UTC--2009-03-04 UTC
[1] 2009-01-01 UTC--2009-02-01 UTC
[1] 2009-02-01 UTC--2009-03-04 UTC
[1] 2009-01-01 UTC--2009-02-01 UTC
[1] 2009-02-01 UTC--2009-03-01 UTC
[1] 2009-01-01 UTC--2018-11-10 UTC

lubridate documentation built on May 30, 2017, 2:10 a.m.

Search within the lubridate package
Search all R packages, documentation and source code