base (version 3.5.1)

round.POSIXt: Round / Truncate Data-Time Objects

Description

Round or truncate date-time objects.

Usage

# S3 method for POSIXt
round(x,
      units = c("secs", "mins", "hours", "days", "months", "years"))
# S3 method for POSIXt
trunc(x,
      units = c("secs", "mins", "hours", "days", "months", "years"),
      …)
# S3 method for Date
round(x, …)
# S3 method for Date
trunc(x, …)

Arguments

x

an object inheriting from "POSIXt" or "Date".

units

one of the units listed. Can be abbreviated.

…

arguments to be passed to or from other methods, notably digits for round.

Value

An object of class "POSIXlt" or "Date".

Details

The time is rounded or truncated to the second, minute, hour, day, month or year. Time zones are only relevant to days or more, when midnight in the current time zone is used.

The methods for class "Date" are of little use except to remove fractional days.

See Also

round for the generic function and default methods.

DateTimeClasses, Date

Examples

# NOT RUN {
round(.leap.seconds + 1000, "hour")
# }
# NOT RUN {
trunc(Sys.time(), "day")
# }