almanac 1.0.0

New features

• New holiday and calendar API and corresponding vignette vignette("holidays-calendars") (#96):

  • rholiday() creates a new holiday from a holiday name and a rschedule that defines when the holiday occurs. There are a number of pre-created holidays prefixed with hol_*(), such as hol_christmas() and hol_us_thanksgiving(). Holidays are rschedules, so you can use all of the alma_*() functions on them.

  • hol_observe(), hol_offset(), and hol_rename() are three helpers for the holiday API. In particular, hol_observe() tweaks a holiday’s observance date to align with when your business actually celebrated that holiday.

  • rcalendar() bundles multiple holidays together into a calendar. Calendars are similar to runion()s, so you can use all the alma_*() functions on these, but they also come with their own specialized API of functions that start with cal_*(), such as cal_match() to look up the holiday name a date corresponds to, and cal_events() to filter for all of the holidays within a particular year.

  • cal_us_federal() is an example calendar representing the federal holidays recognized in the United States.

• New roffset() for creating an rschedule with events that are offset from an existing rschedule (#94).

• New rcustom() for creating an rschedule from manually defined event dates (#90).

• alma_events() has gained a year argument to limit the returned set of events to specific years.

• runion(), rintersect(), and rsetdiff() have all gained ... which allows you to provide rschedules at creation time. This is now the preferred way to create these set-based rschedules (#91).

• Steppers created with stepper() now work as .before and .after arguments of slider::slide_index() and friends (#80).

Lifecycle changes

• The following functions have been deprecated in favor of more intuitively named alternatives (#83):

  • recur_on_mday() -> recur_on_day_of_month()
  • recur_on_wday() -> recur_on_day_of_week()
  • recur_on_yday() -> recur_on_day_of_year()
  • recur_on_yweek() -> recur_on_week_of_year()
  • recur_on_ymonth() -> recur_on_month_of_year()

  These functions are being aggressively deprecated and will be removed in the next minor version of almanac.

• The family of add_*() functions has been deprecated (#92).

  • add_rschedule() has been deprecated in favor of using the ... argument of runion(), rintersect(), and rsetdiff() directly.

  • add_rdates() has been deprecated in favor of using a combination of runion() and rcustom().

  • add_exdates() has been deprecated in favor of using a combination of rsetdiff() and rcustom().

  These functions are being aggressively deprecated and will be removed in the next minor version of almanac.

• The offset argument of recur_on_easter() is deprecated in favor of using roffset() (#94).

Breaking changes

• All almanac class names are now prefixed with almanac_* to avoid potential clashes with other packages.

• The recur_with_week_start() argument wday has been renamed to day.

• The following developer facing functions have been removed because they are either no longer applicable or provided extension mechanisms that are not very useful in practice (#93):

  • new_rbundle()
  • new_runion()
  • new_rintersect()
  • new_rsetdiff()
  • rbundle_restore()

Bug fixes and minor improvements

• recur_for_count() no longer overrides until (#95).

• New almanac_since() and almanac_until() helpers to access the default since and until values used for all rules (#95).

• Greatly improved the print methods of all almanac classes using cli (#86).

• Updated internal JavaScript rrule library to version 2.7.2 (#82).

• R >=3.5.0 is now required, which is in line with tidyverse standards.

almanac 0.1.1

• Explicitly imports R6::R6Class() and V8::v8() to avoid R CMD Check false alarms (#74).

• Fix USBAN error of casting NA_real_ and NaN to integer (#72).

almanac 0.1.0

• Added a NEWS.md file to track changes to the package.