Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rstudio/bigd
Flexibly format dates and times to a given locale
https://github.com/rstudio/bigd
date datetime easy-to-use i18n time
Last synced: 5 days ago
JSON representation
Flexibly format dates and times to a given locale
- Host: GitHub
- URL: https://github.com/rstudio/bigd
- Owner: rstudio
- License: other
- Created: 2018-07-26T04:03:56.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-11-08T15:41:56.000Z (7 days ago)
- Last Synced: 2024-11-08T16:26:24.937Z (7 days ago)
- Topics: date, datetime, easy-to-use, i18n, time
- Language: R
- Homepage: https://rstudio.github.io/bigD/
- Size: 12.9 MB
- Stars: 17
- Watchers: 2
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://CRAN.R-project.org/package=bigD)
[](https://opensource.org/licenses/MIT)
[](https://github.com/rstudio/bigD/actions/workflows/R-CMD-check.yaml)
[](https://app.codecov.io/gh/rstudio/bigD)
[](https://www.repostatus.org/#active)
[](https://CRAN.R-project.org/package=bigD)
[](https://CRAN.R-project.org/package=bigD)
[](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html)
The goal of **bigD** is to provide an easy-to-use solution for formatting dates and times. The main function, `fdt()`, can take dates, times, and datetimes in various formats (including just strings) and it provides a means to format the output in different locales. The formatting syntax is much more powerful than `strptime`-based formatting (plus no need for `%` everywhere). Time zones in the input can be expressed in multiple ways and there's a ton of options for formatting time zones in the output too.
### Examples
Given the ISO-8601 date string `"2018-07-04"`, let's adjust the `format` string to precisely get the date in the form we need. With `"y/M/d"` a nice year/month/day date is returned to us.
```r
fdt(
input = "2018-07-04",
format = "y/M/d"
)
```
```
#> [1] 2018/7/4
```
With variations of the same time parts, it's possible to get a friendlier version of the same date.
```r
fdt(
input = "2018-07-04",
format = "MMMM d, y."
)
```
```
#> [1] July 4, 2018.
```
With the `locale` option, we can localize the date. Let's change up the format string and use the German locale (`"de"`).
```r
fdt(
input = "2018-07-04",
format = "d. MMMM y (EEEE).",
locale = "de"
)
```
```
#> [1] 4. Juli 2018 (Mittwoch).
```
With a datetime string like `"2018-07-24T14:44:22.234343-0800"`, we have more possibilities. This follows the ISO 8601 spec pretty closely and notice that the UTC offset value is added at the end (where it ought to be) to express some time zone information. Let's see a different datetime in French.
```r
fdt(
input = "2018-07-24T14:44:22.234343-0800",
format = "MMM dd HH:mm:ss ZZZZ yyyy",
locale = "fr"
)
```
```
#> [1] juil. 24 14:44:22 GMT-8:00 2018
```
Next, let's take a look at a slight variation in Finnish. In the above the tz offset was formatted with `"ZZZZ"`. Below, let's use `"XX"` for that.
```r
fdt(
input = "2018-07-24T14:44:22.234343-0800",
format = "MMMM dd HH:mm:ss 'yy XX",
locale = "fi"
)
```
```
#> [1] heinäkuuta 24 14:44:22 '18 -0800
```
Time zone support is super comprehensive. We can attach a time zone ID, like `"America/Vancouver"` (and there are many others), to a datetime string. We just got to make sure it's wrapped up in parens.
``` r
fdt(
input = "2014-06-23T13:24:09.84(America/Vancouver)",
format = "yyyy.MM.dd G, HH:mm:ss zzzz",
locale = "es"
)
```
```
#> [1] 2014.06.23 d. C., 13:24:09 hora de verano del Pacífico
```
Just so you know, the time zone ID can alternatively be set to the `use_tz` argument of `fdt()`. Also, POSIXct/POSIXlt/Date times can be used as inputs. Plus, this function is vectorized.
The formatting syntax has a lot to it but you can learn all about it in the fairly comprehensive documentation.
### Installation
Want to try this out? The **bigD** package is available on **CRAN**:
```r
install.packages("bigD")
```
You can also install the development version of **bigD** from **GitHub**:
```r
# install.packages("pak")
pak::pak("rstudio/bigD")
```
If you encounter a bug, have usage questions, or want to share ideas to make this package better, feel free to file an [issue](https://github.com/rstudio/bigD/issues).
##### Code of Conduct
Please note that the `rstudio/bigD` project is released with a [contributor code of conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).
By participating in this project you agree to abide by its terms.
##### 📄 License
**bigD** is licensed under the MIT license. See the [`LICENSE.md`](LICENSE.md) file for more details.
© Posit Software, PBC.
##### 🏛️ Governance
This project is primarily maintained by [Rich Iannone](https://twitter.com/riannone). Should there also be other authors, they might occasionally assist with some of these duties.