WOLFRAM

Wolfram Language & System Documentation Center

DayMatchQ[date,daytype]

returns True if the date matches the daytype specification and returns False otherwise.

DayMatchQ[daytype]

represents an operator form of DayMatchQ that can be applied to a date.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
CalendarType  
HolidayCalendar  
Applications  
Properties & Relations  
Possible Issues  
See Also
Related Guides
History
Cite this Page

DayMatchQ

DayMatchQ[date,daytype]

returns True if the date matches the daytype specification and returns False otherwise.

DayMatchQ[daytype]

represents an operator form of DayMatchQ that can be applied to a date.

Details and Options

  • 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
    timeabsolute time specification
  • Possible day types are:
  • Allany 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 and Islamic calendars, the weekdays are Sunday through Thursday.
  • DayMatchQ takes the following options:
  • CalendarTypeAutomaticcalendar in which the date has been specified
    HolidayCalendar{"UnitedStates","Default"}holiday schedule and subspecification for the business day and holiday computations

Examples

open all close all

Basic Examples  (5)

Find out if today is a weekend day:

Wolfram Language code: DayMatchQ[Today, "Weekend"]

Find out if today is a business day:

Wolfram Language code: DayMatchQ[Today, "BusinessDay"]

Find out if today is a non-weekend holiday:

Wolfram Language code: DayMatchQ[Yesterday, "Holiday"]

Find out if July 4 is a holiday in Brazil:

Wolfram Language code: DayMatchQ[DateObject[{2022, 7, 4}, "Day", "Gregorian", -6.], "Holiday", HolidayCalendar -> "Brazil"]

Find out if July 4 is a holiday in the US:

Wolfram Language code: DayMatchQ[DateObject[{2022, 7, 4}, "Day"], "Holiday", HolidayCalendar -> "UnitedStates"]

Scope  (3)

Input the date in string form:

Wolfram Language code: DayMatchQ["aug. 4, 1980", "Holiday"]

What fraction of the time non-weekend holidays occur on Mondays:

Wolfram Language code: Length[Select[DayRange[{2000}, {2050}, "Holiday"], DayMatchQ[#, Monday]&]] / DayCount[{2000}, {2050}, "Holiday"]//N

Use the operator form to test for a specific day type:

Wolfram Language code: DayMatchQ[Wednesday][DateObject[{2025, 4, 23}, "Day"]]
Wolfram Language code: DayMatchQ["WeekendHoliday"][DateObject[{2025, 1, 1}, "Day"]]

Options  (3)

CalendarType  (1)

A day type will vary depending on the calendar associated with the date:

Wolfram Language code: DayMatchQ[{1948, 5, 14}, "Weekend"]
Wolfram Language code: DayMatchQ[{1948, 5, 14}, "Weekend", CalendarType -> "Jewish"]

HolidayCalendar  (2)

The holiday calendar determines which days qualify as "Holiday":

Wolfram Language code: DayMatchQ[{2026, 4, 6}, "Holiday"]
Wolfram Language code: DayMatchQ[{2026, 4, 6}, "Holiday", HolidayCalendar -> "HongKong"]

Different markets within a country may have different holiday schedules:

Wolfram Language code: CalendarData["UnitedStates"]
Wolfram Language code: DayMatchQ[DateObject[{2022, 4, 15}], "Holiday", CalendarType -> "Gregorian", HolidayCalendar -> {"UnitedStates", "NYSE"}]
Wolfram Language code: DayMatchQ[DateObject[{2022, 4, 15}], "Holiday", CalendarType -> "Gregorian", HolidayCalendar -> "UnitedStates"]

Applications  (1)

Find the countries in this list for which Easter Monday (April 9 in 2012) is a holiday:

Wolfram Language code: CalendarData[]
Wolfram Language code: Select[%, DayMatchQ[DateObject[{2022, 4, 15}], "Holiday", HolidayCalendar -> #]&]

Properties & Relations  (2)

DayRange with a day type specification other than All is equivalent to a Select statement:

Wolfram Language code: DayRange[{2022}, {2023}, "Weekend"] === Select[DayRange[{2022}, {2023}], DayMatchQ[#, "Weekend"]&]

DayMatchQ[date,"BusinessDay"] is equivalent to BusinessDayQ[date]:

Wolfram Language code: DayMatchQ[Today, "BusinessDay"]
Wolfram Language code: BusinessDayQ[Today]

Possible Issues  (2)

A date may only be a holiday if it is not a weekend:

Wolfram Language code: DayMatchQ[{2022, 7, 30}, "Weekend"]
Wolfram Language code: DayMatchQ[{2022, 7, 30}, "Holiday", HolidayCalendar -> {"Gregorian" -> {{True&, # == 7&, # == 30&}}}]

A Sunday is part of the weekend in the Gregorian calendar and therefore cannot be a holiday:

Wolfram Language code: sundayGregorian = DateObject[{2022, 7, 31}]
Wolfram Language code: DayMatchQ[sundayGregorian, "Holiday", HolidayCalendar -> {"Gregorian" -> {{True&, # == 7&, # == 31&}}}]

However, a Sunday is not part of the weekend in the Jewish calendar and therefore can be a holiday:

Wolfram Language code: sundayJewish = CalendarConvert[sundayGregorian, "Jewish"]
Wolfram Language code: DayMatchQ[sundayJewish, "Holiday", HolidayCalendar -> {"Gregorian" -> {{True&, # == 7&, # == 31&}}}]
Wolfram Research (2012), DayMatchQ, Wolfram Language function, https://reference.wolfram.com/language/ref/DayMatchQ.html (updated 2025).

Text

Wolfram Research (2012), DayMatchQ, Wolfram Language function, https://reference.wolfram.com/language/ref/DayMatchQ.html (updated 2025).

CMS

Wolfram Language. 2012. "DayMatchQ." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/DayMatchQ.html.

APA

Wolfram Language. (2012). DayMatchQ. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DayMatchQ.html

BibTeX

@misc{reference.wolfram_2026_daymatchq, author="Wolfram Research", title="{DayMatchQ}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/DayMatchQ.html}", note=[Accessed: 13-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_daymatchq, organization={Wolfram Research}, title={DayMatchQ}, year={2025}, url={https://reference.wolfram.com/language/ref/DayMatchQ.html}, note=[Accessed: 13-June-2026]}