v0.1.2 (#11)

* Add lint tests

* Add functions for `this_week`, `last_week`, and `next_week`

Author: ellisvalentiner

.travis.yml

@@ -6,6 +6,8 @@ cache: packages
 latex: false
 r_packages:
   - covr
+r_github_packages:
+  - jimhester/lintr
 
 env:
   global:

DESCRIPTION

@@ -17,11 +17,13 @@ Imports:
   hms (>= 0.3)
 Suggests:
   knitr (>= 1.17),
+  lintr (>= 1.0.1.9000),
   testthat (>= 1.0.2)
 Remotes:
-  tidyverse/lubridate,
   tidyverse/hms,
   yihui/knitr,
+  jimhester/lintr,
+  tidyverse/lubridate,
   r-lib/testthat
 VignetteBuilder: knitr
 RoxygenNote: 6.0.1

NAMESPACE

@@ -6,8 +6,11 @@ export(hms)
 export(is.weekday)
 export(is.weekend)
 export(last_month)
+export(last_week)
 export(next_month)
+export(next_week)
 export(this_month)
+export(this_week)
 export(tomorrow)
 export(yesterday)
 import(lubridate)

R/instants.R

@@ -2,10 +2,12 @@
 #'
 #' @export yesterday
 #' @param tzone a character vector specifying which time zone you would like to
-#'   find the previous date of. tzone defaults to the system time zone set on your
-#'   computer.
+#'   find the previous date of. tzone defaults to the system time zone set on
+#'   your computer.
 #' @return the previous date as a Date object
 #'
+#' @seealso \code{\link{tomorrow}}
+#'
 #' @examples
 #' yesterday()
 #' yesterday("UTC")
@@ -17,10 +19,12 @@ yesterday <- function(tzone = "") {
 #'
 #' @export tomorrow
 #' @param tzone a character vector specifying which time zone you would like to
-#'   find the previous date of. tzone defaults to the system time zone set on your
-#'   computer.
+#'   find the previous date of. tzone defaults to the system time zone set on
+#'   your computer.
 #' @return the previous date as a Date object
 #'
+#' @seealso \code{\link{yesterday}}
+#'
 #' @examples
 #' tomorrow()
 #' tomorrow("UTC")
@@ -31,10 +35,11 @@ tomorrow <- function(tzone = "") {
 #' The date x days ago
 #'
 #' @export days_ago
-#' @param days an integer specifying the number of days to subtract from the current
+#' @param days an integer specifying the number of days to subtract from the
+#'   current
 #' @param tzone a character vector specifying which time zone you would like to
-#'   find the previous date of. tzone defaults to the system time zone set on your
-#'   computer.
+#'   find the previous date of. tzone defaults to the system time zone set on
+#'   your computer.
 #' @return the date, x days ago
 #'
 #' @examples
@@ -49,8 +54,8 @@ days_ago <- function(days = 0, tzone = "") {
 #' @export days_hence
 #' @param days an integer specifying the number of days to add from the current
 #' @param tzone a character vector specifying which time zone you would like to
-#'   find the previous date of. tzone defaults to the system time zone set on your
-#'   computer.
+#'   find the previous date of. tzone defaults to the system time zone set on
+#'   your computer.
 #' @return the date, x days hence
 #'
 #' @examples
@@ -64,8 +69,8 @@ days_hence <- function(days = 0, tzone = "") {
 #'
 #' @export this_month
 #' @param tzone a character vector specifying which time zone you would like to
-#'   find the current month of. tzone defaults to the system time zone set on your
-#'   computer.
+#'   find the current month of. tzone defaults to the system time zone set on
+#'   your computer.
 #' @return the current month as a Date object
 this_month <- function(tzone = "") {
   floor_date(x = today(tzone = tzone), unit = "month")
@@ -75,8 +80,8 @@ this_month <- function(tzone = "") {
 #'
 #' @export last_month
 #' @param tzone a character vector specifying which time zone you would like to
-#'   find the previous month of. tzone defaults to the system time zone set on your
-#'   computer.
+#'   find the previous month of. tzone defaults to the system time zone set on
+#'   your computer.
 #' @return the previous month as a Date object
 last_month <- function(tzone = "") {
   floor_date(x = today(tzone = tzone), unit = "month") - months(1)
@@ -93,6 +98,39 @@ next_month <- function(tzone = "") {
   floor_date(x = today(tzone = tzone), unit = "month") + months(1)
 }
 
+#' The current week
+#'
+#' @export this_week
+#' @param tzone a character vector specifying which time zone you would like to
+#'   find the current week of. tzone defaults to the system time zone set on
+#'   your computer.
+#' @return the current week as a Date object
+this_week <- function(tzone = "") {
+  floor_date(x = today(tzone = tzone), unit = "week")
+}
+
+#' The previous week
+#'
+#' @export last_week
+#' @param tzone a character vector specifying which time zone you would like to
+#'   find the previous week of. tzone defaults to the system time zone set on
+#'   your computer.
+#' @return the previous week as a Date object
+last_week <- function(tzone = "") {
+  floor_date(x = today(tzone = tzone), unit = "week") - weeks(1)
+}
+
+#' The next week
+#'
+#' @export next_week
+#' @param tzone a character vector specifying which time zone you would like to
+#'   find the next week of. tzone defaults to the system time zone set on your
+#'   computer.
+#' @return the next month as a Date object
+next_week <- function(tzone = "") {
+  floor_date(x = today(tzone = tzone), unit = "week") + weeks(1)
+}
+
 #' Is x a weekend?
 #'
 #' @export is.weekend
@@ -130,5 +168,5 @@ is.weekday <- function(x) {
 #' @examples
 #' hms("2017-10-22 15:01:00")
 hms <- function(x) {
-  hms::as.hms(strftime(x, format="%H:%M:%S"))
+  hms::as.hms(strftime(x, format = "%H:%M:%S"))
 }

README.md

@@ -1,18 +1,21 @@
 
 <!-- README.md is generated from README.Rmd. Please edit that file -->
-lubridateExtras <img src="man/figures/logo.svg" align="right" height="120" width="139" />
-=========================================================================================
+
+# lubridateExtras <img src="man/figures/logo.svg" align="right" height="120" width="139" />
 
 Convenience functions for the lubridate package
 
 <!-- Placeholder for build status, CRAN status, and coverage status -->
-Overview
---------
 
-Lubridate makes it easier to work with date-time data in R and provides new capabilities. LubridateExtras builds on top of lubridate to provide a number of convenience functions, primarily focused on abstracting patterns in ways that improve code readability and reduce copying and pasting code.
+## Overview
+
+Lubridate makes it easier to work with date-time data in R and provides
+new capabilities. LubridateExtras builds on top of lubridate to provide
+a number of convenience functions, primarily focused on abstracting
+patterns in ways that improve code readability and reduce copying and
+pasting code.
 
-Installation
-------------
+## Installation
 
 ``` r
 # lubridateExtras is not currently on CRAN
@@ -21,33 +24,35 @@ Installation
 devtools::install_github("ellisvalentiner/lubridateExtras")
 ```
 
-If you encounter a clear bug, please file a minimal reproducible example on [github](https://github.com/ellisvalentiner/lubridateExtras/issues).
+If you encounter a clear bug, please file a minimal reproducible example
+on [github](https://github.com/ellisvalentiner/lubridateExtras/issues).
 
-Usage
------
+## Usage
 
 ``` r
 library(lubridateExtras)
 
 yesterday()
-#> [1] "2017-10-21"
+#> [1] "2018-02-20"
 
 tomorrow()
-#> [1] "2017-10-23"
+#> [1] "2018-02-22"
 
 days_ago(7)  # equivalent to lubridate::today() - lubridate::days(7)
-#> [1] "2017-10-15"
+#> [1] "2018-02-14"
 
 days_hence(7)  # equivalent to lubridate::today() + lubridate::days(7)
-#> [1] "2017-10-29"
+#> [1] "2018-02-28"
 
 hms("2017-10-22 15:33:00")  # extracts the time-of-day component
 #> 15:33:00
 ```
 
-Why lubridateExtras?
---------------------
+## Why lubridateExtras?
 
 Some people are probably asking the question: why lubridateExtras?
 
-lubridateExtras does not do anything that you cannot do with lubridate but similarly you don't need lubridate at all to work with date/times in R! If you like the syntactic sugar of lubridateExtras then use it, otherwise stick with what works for you.
+lubridateExtras does not do anything that you cannot do with lubridate
+but similarly you don’t need lubridate at all to work with date/times in
+R\! If you like the syntactic sugar of lubridateExtras then use it,
+otherwise stick with what works for you.

_pkgdown.yml

@@ -19,3 +19,9 @@ navbar:
   right:
   - icon: fa-github fa-lg
     href: https://github.com/ellisvalentiner/lubridateExtras
+
+reference:
+  - title: similar functions
+    contents:
+    - yesterday
+    - tomorrow