R/datetime_as_isoweek.R

In parksandwildlife/wastdr: WA Sea Turtle Database 'WAStD' API Wrapper

#' Calculate the isoweek from a given datetime
#'
#' \lifecycle{stable}
#'
#' @details Return the isoweek of a given datetime.
#'
#' The isoweek is useful as a grouping variable for weekly summaries.
#'
#' @param datetime (dttm) A datetime
#' @return The ISO week as int, e.g. 26
#' @importFrom lubridate days isoweek
#' @export
#' @family helpers
#' @examples
#' # These datetimes are turtle season 2017:
#' datetime_as_isoweek(httpdate_as_gmt08("2017-06-30T15:59:59Z")) # 26
#' datetime_as_isoweek(httpdate_as_gmt08("2017-06-30T16:00:00Z")) # 26
#' datetime_as_isoweek(httpdate_as_gmt08("2017-08-30T06:38:43Z")) # 35
#' datetime_as_isoweek(httpdate_as_gmt08("2017-11-01T22:00:00Z")) # 44
#' datetime_as_isoweek(httpdate_as_gmt08("2018-11-01T22:00:00Z")) # 44
datetime_as_isoweek <- function(datetime) {
  datetime %>% lubridate::isoweek()
}

# usethis::use_test("datetime_as_isoweek")