--- title: "DayRound" language: "en" type: "Symbol" summary: "DayRound[date, daytype] rounds date to the nearest day of daytype, using the next-day rounding convention. DayRound[date, daytype, rounding] rounds date to the nearest day of daytype, using rounding." keywords: - dates - finance - holidays - holiday calendar - business days - islamic calendar - jewish calendar - gregorian - julian - nearest business date - business date adjustment - adjust date canonical_url: "https://reference.wolfram.com/language/ref/DayRound.html" source: "Wolfram Language Documentation" related_guides: - title: "Date & Time" link: "https://reference.wolfram.com/language/guide/DateAndTime.en.md" related_functions: - title: "CurrentDate" link: "https://reference.wolfram.com/language/ref/CurrentDate.en.md" - title: "NextDate" link: "https://reference.wolfram.com/language/ref/NextDate.en.md" - title: "PreviousDate" link: "https://reference.wolfram.com/language/ref/PreviousDate.en.md" - 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: "DayPlus" link: "https://reference.wolfram.com/language/ref/DayPlus.en.md" --- # DayRound DayRound[date, daytype] rounds date to the nearest day of daytype, using the next-day rounding convention. DayRound[date, daytype, rounding] rounds date to the nearest day of daytype, using rounding. ## Details and Options * ``DayRound`` returns a ``DateObject`` expression. * A 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 | * 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``. * ``DayRound[date]`` is equivalent to ``DayRound[date, All]``. * Recognized rounding values are: ``"Next"``, ``"Following"``, ``"ModifiedFollowing"``, ``"Preceding"``, ``"Previous"``, and ``"ModifiedPreceding"``. * If ``date`` is of ``daytype``, ``DayRound`` has no effect. * ``DayRound`` 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 (8) ### Basic Examples (3) Adjust the first of the year to the nearest following business day: ```wl In[1]:= DayRound[{2022}, "BusinessDay"] Out[1]= DateObject[{2022, 1, 3}, "Day"] ``` --- Determine the nearest weekend day following the beginning of February 2012: ```wl In[1]:= DayRound[{2022, 2}, "Weekend"] Out[1]= DateObject[{2022, 2, 5}, "Day"] ``` --- Find the next Sunday: ```wl In[1]:= DayRound[{2022, 2, 1}, Sunday] Out[1]= DateObject[{2022, 2, 6}, "Day"] ``` --- If no day type specification is given, the date will be rounded to ``"Day"`` granularity: ```wl In[1]:= DayRound[Now] Out[1]= DateObject[{2025, 8, 25}, "Day", "Gregorian", -5.] ``` --- ### Scope (2) Adjust a date, subject to a business day convention: ```wl In[1]:= DayRound[{2021}, "BusinessDay", "ModifiedFollowing"] Out[1]= DateObject[{2021, 1, 4}, "Day"] ``` --- ``"ModifiedFollowing"`` rounds to the next business day, unless it is in another month: ```wl In[1]:= DayRound[{2022, 3, 31}, "BusinessDay", "ModifiedFollowing"] Out[1]= DateObject[{2022, 3, 31}, "Day"] ``` ### Options (2) #### CalendarType (1) Compute the next business day using Jewish calendar dates: ```wl In[1]:= DayRound[Today, "BusinessDay", CalendarType -> "Jewish"] Out[1]= DateObject[{5782, 12, 2}, "Day", "Jewish"] ``` #### HolidayCalendar (1) Different markets within a country may have different holiday schedules: ```wl In[1]:= Table[DayRound[{2022, 1, 16}, "BusinessDay", "ModifiedFollowing", HolidayCalendar -> {"UnitedStates", i}], {i, CalendarData["UnitedStates"]}] Out[1]= {DateObject[{2022, 1, 18}, "Day"], DateObject[{2022, 1, 18}, "Day"], DateObject[{2022, 1, 18}, "Day"], DateObject[{2022, 1, 17}, "Day"], DateObject[{2022, 1, 18}, "Day"]} ``` ### Applications (1) Adjust a date, subject to various conventions: ```wl In[1]:= Table[DayRound[{2022, 1, 1}, "BusinessDay", i], {i, {"Following", "ModifiedFollowing", "Previous", "ModifiedPreceding"}}] Out[1]= {DateObject[{2022, 1, 3}, "Day"], DateObject[{2022, 1, 3}, "Day"], DateObject[{2021, 12, 30}, "Day"], DateObject[{2022, 1, 3}, "Day"]} ``` ## See Also * [`CurrentDate`](https://reference.wolfram.com/language/ref/CurrentDate.en.md) * [`NextDate`](https://reference.wolfram.com/language/ref/NextDate.en.md) * [`PreviousDate`](https://reference.wolfram.com/language/ref/PreviousDate.en.md) * [`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) * [`DayPlus`](https://reference.wolfram.com/language/ref/DayPlus.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)