How to Use lubridate in R for Easy Date-Time Handling

Use the lubridate package in R by first installing and loading it with install.packages("lubridate") and library(lubridate). Then use its functions like ymd(), mdy(), or now() to parse and manipulate dates and times easily.

Syntax

The lubridate package provides simple functions to work with dates and times. Common functions include:

• ymd(), mdy(), dmy(): Parse strings into dates in year-month-day, month-day-year, or day-month-year order.
• now(): Get the current date and time.
• today(): Get the current date.
• year(), month(), day(): Extract parts of a date.
• hours(), minutes(), seconds(): Create time durations.

These functions simplify date-time parsing and arithmetic without complex formatting.

r

library(lubridate)

# Parse a date string in year-month-day format
date1 <- ymd("2024-06-15")

# Get current date and time
now_time <- now()

# Extract year, month, day
yr <- year(date1)
mo <- month(date1)
dy <- day(date1)

# Create a duration of 2 hours
dur <- hours(2)

Example

This example shows how to parse dates, extract parts, and add durations using lubridate.

r

library(lubridate)

# Parse a date string
my_date <- mdy("12-25-2023")

# Print the parsed date
print(my_date)

# Extract year, month, day
print(year(my_date))
print(month(my_date))
print(day(my_date))

# Add 3 days to the date
new_date <- my_date + days(3)
print(new_date)

# Get current date and time
current <- now()
print(current)

Output

[1] "2023-12-25"
[1] 2023
[1] 12
[1] 25
[1] "2023-12-28"
[1] "2024-06-15 12:00:00 UTC"

Common Pitfalls

Common mistakes when using lubridate include:

• Not loading the package with library(lubridate) before using its functions.
• Using the wrong parsing function for the date format (e.g., using ymd() on a month-day-year string).
• Forgetting that date arithmetic requires durations like days() or hours() to add or subtract time.

Always check your date format and use the matching parser.

r

library(lubridate)

# Wrong: parsing month-day-year with ymd()
date_wrong <- ymd("12-25-2023")
print(date_wrong)  # Gives NA because format mismatches

# Right: use mdy() for month-day-year
date_right <- mdy("12-25-2023")
print(date_right)

Output

[1] NA
[1] "2023-12-25"

Quick Reference

Function	Purpose	Example
ymd()	Parse date in year-month-day format	ymd("2024-06-15")
mdy()	Parse date in month-day-year format	mdy("06-15-2024")
dmy()	Parse date in day-month-year format	dmy("15-06-2024")
now()	Get current date and time	now()
today()	Get current date	today()
year()	Extract year from date	year(ymd("2024-06-15"))
month()	Extract month from date	month(ymd("2024-06-15"))
day()	Extract day from date	day(ymd("2024-06-15"))
days()	Create duration of days	days(3)
hours()	Create duration of hours	hours(2)

Key Takeaways

Always load lubridate with library(lubridate) before use.

Use the correct parsing function (ymd, mdy, dmy) matching your date format.

Use duration functions like days() or hours() for date arithmetic.

lubridate simplifies date-time handling compared to base R.

Check your date formats carefully to avoid parsing errors.