/
README.Rmd
103 lines (72 loc) · 3.68 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures"
)
```
# lubridate <img src="man/figures/logo.png" align="right" />
<!-- badges: start -->
[](https://cran.r-project.org/package=lubridate)
[](https://github.com/tidyverse/lubridate/actions)
[](https://app.codecov.io/gh/tidyverse/lubridate)
[](https://cran.r-project.org/package=lubridate)
[](https://github.com/tidyverse/lubridate)
[](https://github.com/tidyverse/lubridate/actions)
<!-- badges: end -->
## Overview
Date-time data can be frustrating to work with in R. R commands for date-times are generally unintuitive and change depending on the type of date-time object being used. Moreover, the methods we use with date-times must be robust to time zones, leap days, daylight savings times, and other time related quirks, and R lacks these capabilities in some situations. Lubridate makes it easier to do the things R does with date-times and possible to do the things R does not.
If you are new to lubridate, the best place to start is the
[date and times chapter](https://r4ds.had.co.nz/dates-and-times.html) in R
for data science.
## Installation
```{r, eval = FALSE}
# The easiest way to get lubridate is to install the whole tidyverse:
install.packages("tidyverse")
# Alternatively, install just lubridate:
install.packages("lubridate")
# Or the development version from GitHub:
# install.packages("devtools")
devtools::install_github("tidyverse/lubridate")
```
## Cheatsheet
<a href="https://rawgit.com/rstudio/cheatsheets/main/lubridate.pdf"><img src="https://raw.githubusercontent.com/rstudio/cheatsheets/main/pngs/thumbnails/lubridate-cheatsheet-thumbs.png" width="630" height="252"/></a>
## Features
```{r}
library(lubridate, warn.conflicts = FALSE)
```
* Easy and fast parsing of date-times: `ymd()`, `ymd_hms`, `dmy()`, `dmy_hms`,
`mdy()`, ...
```{r}
ymd(20101215)
mdy("4/1/17")
```
* Simple functions to get and set components of a date-time, such as `year()`,
`month()`, `mday()`, `hour()`, `minute()` and `second()`:
```{r}
bday <- dmy("14/10/1979")
month(bday)
wday(bday, label = TRUE)
year(bday) <- 2016
wday(bday, label = TRUE)
```
* Helper functions for handling time zones: `with_tz()`, `force_tz()`
```{r}
time <- ymd_hms("2010-12-13 15:30:30")
time
# Changes printing
with_tz(time, "America/Chicago")
# Changes time
force_tz(time, "America/Chicago")
```
Lubridate also expands the type of mathematical operations that can be performed with date-time objects. It introduces three new time span classes borrowed from https://www.joda.org.
* `durations`, which measure the exact amount of time between two points
* `periods`, which accurately track clock times despite leap years, leap
seconds, and day light savings time
* `intervals`, a protean summary of the time information between two points
## Code of Conduct
Please note that the lubridate project is released with a [Contributor Code of Conduct](https://lubridate.tidyverse.org/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.