xts (version 0.13.1)

align.time: Align seconds, minutes, and hours to beginning of next period.

Description

Change timestamps to the start of the next period, specified in multiples of seconds.

Usage

align.time(x, ...)
# S3 method for xts
align.time(x, n=60, ...)
shift.time(x, n=60, ...)
adj.time(x, ...)

Value

A new object of class(x)

Arguments

x

object to align

n

number of seconds to adjust by

...

additional arguments. See details.

Author

Jeffrey A. Ryan with input from Brian Peterson

Details

This function is an S3 generic. The result is to round up to the next period determined by n modulo x.

See Also

to.period

Examples

x <- Sys.time() + 1:1000

# every 10 seconds
align.time(x, 10)

# align to next whole minute
align.time(x, 60)

# align to next whole 10 min interval
align.time(x, 10 * 60)