--- title: "DayPlus" language: "en" type: "Symbol" summary: "DayPlus[date, n] gives the date n days away from date. DayPlus[date, n, daytype] gives the date that is n days of daytype away from date." keywords: - dates - finance - holidays - holiday calendar - business days - islamic calendar - jewish calendar - gregorian - julian canonical_url: "https://reference.wolfram.com/language/ref/DayPlus.html" source: "Wolfram Language Documentation" related_guides: - title: "Date & Time" link: "https://reference.wolfram.com/language/guide/DateAndTime.en.md" related_functions: - title: "DatePlus" link: "https://reference.wolfram.com/language/ref/DatePlus.en.md" - title: "DayRange" link: "https://reference.wolfram.com/language/ref/DayRange.en.md" - title: "DateDifference" link: "https://reference.wolfram.com/language/ref/DateDifference.en.md" - title: "DayRound" link: "https://reference.wolfram.com/language/ref/DayRound.en.md" --- # DayPlus DayPlus[date, n] gives the date n days away from date. DayPlus[date, n, daytype] gives the date that is n days of daytype away from date. ## Details and Options * Date can be specified in the following forms: | | | | ------------------ | ------------------------------------ | | DateObject[…] | date object | | {y, m, d} | year, month, day | | {y, m} | the first day of the specified month | | {y} | January 1 of the year y | | "string" | date as a string ("Jan. 1, 2000") | | {y, m, d, h, m, s} | precise time | | time | absolute time specification | * ``DayPlus`` returns a ``DateObject``. * Possible day types are: | | | | ------------------- | ------------------------------------ | | All | any calendar date (default) | | "Weekday" | date considered a weekday | | "Weekend" | date considered a weekend | | "Holiday" | holiday according to HolidayCalendar | | "NonHoliday" | date that is not a holiday | | "BusinessDay" | non-holiday weekday | | "NonBusinessDay" | holiday or weekend | | "WeekdayHoliday" | holiday on a weekday | | "WeekendHoliday" | holiday on a weekend | | "WeekendNonHoliday" | non-holiday weekend | | Monday, Tuesday, … | a specific day of the week | | "EndOfMonth" | final day of a given month | | "BeginningOfMonth" | first day of a given month | * In the Jewish calendar, the weekdays are ``Sunday`` through ``Thursday``. * ``DayPlus`` takes the following options: | | | | | --------------- | --------------------------- | ----------------------------------------------------------------------------------- | | CalendarType | Automatic | calendar in which the dates have been specified | | HolidayCalendar | {"UnitedStates", "Default"} | holiday schedule and subspecification for the business day and holiday computations | --- ## Examples (10) ### Basic Examples (4) Five days from the first of the year: ```wl In[1]:= DayPlus[{2022}, 5] Out[1]= DateObject[{2022, 1, 6}, "Day"] ``` --- Five days before the first of the year: ```wl In[1]:= DayPlus[{2022}, -5] Out[1]= DateObject[{2021, 12, 27}, "Day"] ``` --- Five business days from today: ```wl In[1]:= DayPlus[Today, 5, "BusinessDay"] Out[1]= DateObject[{2022, 2, 10}, "Day"] ``` --- Five Sundays away from the first of March 2022: ```wl In[1]:= DayPlus[{2022, 3}, 5, Sunday] Out[1]= DateObject[{2022, 4, 3}, "Day"] ``` ### Scope (2) 250 Sundays away: ```wl In[1]:= DayPlus[{2022}, -250, Sunday] Out[1]= DateObject[{2017, 3, 19}, "Day"] ``` --- There are about 250 business days in a year: ```wl In[1]:= DayPlus[{2022, 1, 1}, 250, "BusinessDay"] Out[1]= DateObject[{2022, 12, 29}, "Day"] ``` ### Options (3) #### CalendarType (1) Compute the Islamic day five business days away, subject to the US holiday schedule: ```wl In[1]:= DayPlus[{1443, 7, 1}, 5, "BusinessDay", CalendarType -> "Islamic"] Out[1]= DateObject[{1443, 7, 8}, "Day", "Islamic"] ``` #### HolidayCalendar (2) Compare the dates 250 business days away in different countries: ```wl In[1]:= Table[DayPlus[{2022}, 250, "BusinessDay", HolidayCalendar -> i], {i, {"China", "UnitedStates"}}] Out[1]= {DateObject[{2023, 1, 6}, "Day"], DateObject[{2022, 12, 29}, "Day"]} ``` --- Different markets within a country may have different holiday schedules: ```wl In[1]:= Table[DayPlus[{2022, 4}, 30, "BusinessDay", HolidayCalendar -> {"UnitedStates", i}], {i, CalendarData["UnitedStates"]}] Out[1]= {DateObject[{2022, 5, 13}, "Day"], DateObject[{2022, 5, 16}, "Day"], DateObject[{2022, 5, 13}, "Day"], DateObject[{2022, 5, 13}, "Day"], DateObject[{2022, 5, 16}, "Day"]} ``` ### Properties & Relations (1) Business date difference can be computed by using ``DayCount`` : ```wl In[1]:= With[{first = Take[DateList[], 2]}, DayCount[first, DatePlus[first, {{1, "Month"}, {-1, "Day"}}], "BusinessDay"]] Out[1]= 18 ``` ## See Also * [`DatePlus`](https://reference.wolfram.com/language/ref/DatePlus.en.md) * [`DayRange`](https://reference.wolfram.com/language/ref/DayRange.en.md) * [`DateDifference`](https://reference.wolfram.com/language/ref/DateDifference.en.md) * [`DayRound`](https://reference.wolfram.com/language/ref/DayRound.en.md) ## Related Guides * [Date & Time](https://reference.wolfram.com/language/guide/DateAndTime.en.md) ## History * [Introduced in 2012 (9.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn90.en.md) \| [Updated in 2014 (10.0)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn100.en.md) ▪ [2025 (14.3)](https://reference.wolfram.com/language/guide/SummaryOfNewFeaturesIn143.en.md)