dint
A Toolkit for Year-Quarter, Year-Month and Year-Isoweek Dates
S3 classes and methods to create and work with year-quarter, year-month and year-isoweek vectors. Basic arithmetic operations (such as adding and subtracting) are supported, as well as formatting and converting to and from standard R date types.
A Toolkit for Year-Quarter, Year-Month and Year-Isoweek Dates
S3 classes and methods to create and work with year-quarter and year-month vectors. Basic arithmetic operations (such as adding and subtracting) are supported, as well as formatting and converting to and from standard R Date types. For more info please refer to the package vignette or the documentation
Dependencies
dint is implemented strictly in base R and will always stay dependency-free. The optional dependencies in Suggests are to ensure interoperability with these packages if you are already using them.
Installation
Install the release version of dint from CRAN:
install.packages("dint")
Or install the development version from GitHub with:
devtools::install_github("s-fleck/dint")
Example
library(dint)# creationq <- date_yq(2014, 4)m <- as_date_ym(201412)w <- as_date_yw(as.Date("2017-01-01"))# printingprint(q)#> [1] "2014-Q4"print(m)#> [1] "2014-M12"print(w) # isoweeks do not follow calendar years!#> [1] "2016-W52"# arithmetic operations# quartersq#> [1] "2014-Q4"q + 1#> [1] "2015-Q1"seq(q -2, q + 2)#> [1] "2014-Q2" "2014-Q3" "2014-Q4" "2015-Q1" "2015-Q2"# monthsm#> [1] "2014-M12"m + 1#> [1] "2015-M01"seq(m -2, m + 2)#> [1] "2014-M10" "2014-M11" "2014-M12" "2015-M01" "2015-M02"# formattingformat(q)#> [1] "2014-Q4"format(q, "%Y.%q")#> [1] "2014.4"format(q, "%y.%q")#> [1] "14.4"format(m)#> [1] "2014-M12"# get start and end of periodlast_of_quarter(q)#> [1] "2014-12-31"first_of_quarter(q)#> [1] "2014-10-01"first_of_month(Sys.Date())#> [1] "2018-12-01"first_of_isoweek(w)#> [1] "2016-12-26"last_of_isoweek(w)#> [1] "2017-01-01"
News
dint 2.0.0.9000
- added ggplot2 scales for dint data types
- added predicates to check whether dates correspond to the boundaries of
years or quarters (
is_quarter_bounds(),is_year_bounds(),is_first_of_quarter(), etc...) - export methods for
uniqueandsummarythat were introduced in the last version but mistakenly not exported - One can now subtract two
date_xxof the same subclass from each other (the result is aninteger) - added
as_yearmon()andas_yearqtr()for converting to zoo S3 classes - Removed functions that were deprecated with dint 2.0.0
- added
Sys.date_yq(),Sys.date_ym()andSys.date_yw()to get the current quarter, month or isoweek. - lots of small fixes
dint 2.0.0
- breaking: formatting
date_xxobjects now uses placeholders similar tobase::strptime()(e.g%Y,%m,%q, etc...) instead of presets. The new implementation is also noticeably faster than the old. - breaking: all
first_day_of_*()andformat_date_y*()functions now have shorter names:first_of_*()andformat_y*(). The original names will still work until the next release but give a deprecation warning. - Added support for
c(),min(),max(),range() - You can now directly supply a numeric year to
first_of_year()andlast_of_year()(e.g.first_of_year(2018)) - added
date_ywfor storing isoweeks and modified existing functions to accommodate for them. - added
[method fordate_xxobjects that preserves class attribute when subsetting %y+%/%y-%can add/subtract years from date_xx objects- added the predicates,
is_first_of_quarter(),is_last_of_quarter(), andis_quarter_bounds(). seq()methods now support abyargument
dint 1.0.0
- First stable version