R: Date, date-time, and duration S3 classes

new_date {vctrs} | R Documentation

## Date, date-time, and duration S3 classes

### Description

- A `date` (Date) is a double vector. Its value represent the number of days since the Unix "epoch", 1970-01-01. It has no attributes.

- A `datetime` (POSIXct is a double vector. Its value represents the number of seconds since the Unix "Epoch", 1970-01-01. It has a single attribute: the timezone (`tzone`))

- A `duration` (difftime)

### Usage

    new_date(x = double())

    new_datetime(x = double(), tzone = "")

    new_duration(x = double(), units = c("secs", "mins", "hours", "days", "weeks"))

    ## S3 method for class 'Date'
    vec_ptype2(x, y, ...)

    ## S3 method for class 'POSIXct'
    vec_ptype2(x, y, ...)

    ## S3 method for class 'POSIXlt'
    vec_ptype2(x, y, ...)

    ## S3 method for class 'difftime'
    vec_ptype2(x, y, ...)

    ## S3 method for class 'Date'
    vec_cast(x, to, ...)

    ## S3 method for class 'POSIXct'
    vec_cast(x, to, ...)

    ## S3 method for class 'POSIXlt'
    vec_cast(x, to, ...)

    ## S3 method for class 'difftime'
    vec_cast(x, to, ...)

    ## S3 method for class 'Date'
    vec_arith(op, x, y, ...)

    ## S3 method for class 'POSIXct'
    vec_arith(op, x, y, ...)

    ## S3 method for class 'POSIXlt'
    vec_arith(op, x, y, ...)

    ## S3 method for class 'difftime'
    vec_arith(op, x, y, ...)

### Arguments

`x` | A double vector representing the number of days since UNIX epoch for `new_date()`, number of seconds since UNIX epoch for `new_datetime()`, and number of `units` for `new_duration()`.
`tzone` | Time zone. A character vector of length 1. Either `""` for the local time zone, or a value from `OlsonNames()`
`units` | Units of duration.

### Details

These function help the base `Date`, `POSIXct`, and `difftime` classes fit into the vctrs type system by providing constructors, coercion functions, and casting functions.

### Examples

    new_date(0)
    new_datetime(0, tzone = "UTC")
    new_duration(1, "hours")

[Package vctrs version 0.3.2 Index]