date: Get/set date component of a date-time

In lubridate: Make Dealing with Dates a Little Easier

Get/set date component of a date-time

Description

Date-time must be a POSIXct, POSIXlt, Date, chron, yearmon, yearqtr, zoo, zooreg, timeDate, xts, its, ti, jul, timeSeries, and fts objects.

Usage

date(x)

date(x) <- value

Arguments

x	a date-time object
value	an object for which the date() function is defined

Details

date() does not yet support years before 0 C.E. Also date() is not defined for Period objects.

Value

the date of x as a Date

Base compatibility

date() can be called without any arguments to return a string representing the current date-time. This provides compatibility with base:date() which it overrides.

Examples

x <- ymd_hms("2012-03-26 23:12:13", tz = "America/New_York")
date(x)
as.Date(x) # by default as.Date assumes you want to know the date in UTC
as.Date(x, tz = "America/New_York")
date(x) <- as.Date("2000-01-02")
x

lubridate documentation built on April 3, 2025, 6:43 p.m.