WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

DayMatchQ
✖
DayMatchQ

✖
DayMatchQ[date,daytype]

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

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}the first day of the first month of the year y
    "string"date as a string ("Jan. 1, 2000")
  • Possible day types are: All (default), "Weekday", "Weekend", Monday through Sunday, "EndOfMonth", "BeginningOfMonth", "BusinessDay", and "Holiday".
  • DayMatchQ takes the following options:
  • CalendarType "Gregorian"calendar in which the date has been specified
    HolidayCalendar {"UnitedStates","Default"}holiday schedule and subspecification for the business day and holiday computations
  • In the Jewish calendar, the weekdays are Sunday through Thursday.

Examples

open allclose all

Basic Examples  (5)Summary of the most common use cases

Find out if today is a weekend day:

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-iqieu8
Out[1]=1

Find out if today is a business day:

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-g5i5i1
Out[1]=1

Find out if today is a non-weekend holiday:

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-t8vbz
Out[1]=1

Find out if July 4 is a holiday in Brazil:

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-k8nwp1
Out[1]=1

Or in the US:

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-edgpq
Out[1]=1

Scope  (2)Survey of the scope of standard use cases

Input the date in string form:

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-jehu9
Out[1]=1

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

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-mscm27
Out[1]=1

Options  (3)Common values & functionality for each option

CalendarType  (1)

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

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-nwxr1a
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0pu0js2v8z-jd86vf
Out[2]=2

HolidayCalendar  (2)

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

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-fncnek
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0pu0js2v8z-d36nzd
Out[2]=2

Different markets within a country may have different holiday schedules:

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-ezamfy
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0pu0js2v8z-e49knk
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0pu0js2v8z-c3c3c3
Out[3]=3

Applications  (1)Sample problems that can be solved with this function

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

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-b6gabl
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0pu0js2v8z-bx91ge
Out[2]=2

Properties & Relations  (1)Properties of the function, and connections to other functions

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

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-qawc4
Out[1]=1

Possible Issues  (2)Common pitfalls and unexpected behavior

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

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-njepj2
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0pu0js2v8z-ba5e7x
Out[2]=2

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

In[1]:=1
✖
https://wolfram.com/xid/0pu0js2v8z-x5sgpr
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0pu0js2v8z-gd1d2i
Out[2]=2

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

In[3]:=3
✖
https://wolfram.com/xid/0pu0js2v8z-ee4pkc
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0pu0js2v8z-bhkwwm
Out[4]=4
Wolfram Research (2012), DayMatchQ, Wolfram Language function, https://reference.wolfram.com/language/ref/DayMatchQ.html (updated 2014).
✖
Wolfram Research (2012), DayMatchQ, Wolfram Language function, https://reference.wolfram.com/language/ref/DayMatchQ.html (updated 2014).

Text

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

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

CMS

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

✖
Wolfram Language. 2012. "DayMatchQ." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2014. 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

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

BibTeX

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

✖
@misc{reference.wolfram_2025_daymatchq, author="Wolfram Research", title="{DayMatchQ}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/DayMatchQ.html}", note=[Accessed: 24-April-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_daymatchq, organization={Wolfram Research}, title={DayMatchQ}, year={2014}, url={https://reference.wolfram.com/language/ref/DayMatchQ.html}, note=[Accessed: 24-April-2025 ]}

✖
@online{reference.wolfram_2025_daymatchq, organization={Wolfram Research}, title={DayMatchQ}, year={2014}, url={https://reference.wolfram.com/language/ref/DayMatchQ.html}, note=[Accessed: 24-April-2025 ]}