R: Round / Truncate Data-Time Objects

round.POSIXt {base} | R Documentation

## Round / Truncate Data-Time Objects

### Description

Round or truncate date-time objects.

### Usage

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

    ## S3 method for class 'Date'
    round(x, ...)
    ## S3 method for class '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`.

### 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.

### Value

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

### See Also

`round` for the generic function and default methods.

`DateTimeClasses`, `Date`

### Examples

    round(.leap.seconds + 1000, "hour")
    trunc(Sys.time(), "day")

[Package base version 3.5.1 Index]