WOLFRAM

Wolfram Language & System Documentation Center

DateWithinQ[date1,date2]

returns True if the calendar date date2 is entirely contained within date1, and False otherwise.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Properties & Relations  
See Also
Related Guides
History
Cite this Page

DateWithinQ

DateWithinQ[date1,date2]

returns True if the calendar date date2 is entirely contained within date1, and False otherwise.

Details

  • In DateWithinQ[date1, date2], both date1 and date2 should be specified as DateObject expressions of any calendar granularity.
  • DateWithinQ accepts lists of dates in both arguments, effectively calling Outer on the input lists.
  • DateWithinQ returns True only if date2 falls entirely within the period represented by date1.

Examples

open all close all

Basic Examples  (2)

Now falls within Today:

Wolfram Language code: DateWithinQ[Today, Now]

But it does not fall within Yesterday:

Wolfram Language code: DateWithinQ[Yesterday, Now]

Test whether a given date is within the year 2022:

Wolfram Language code: DateWithinQ[DateObject[{2022}, "Year"], DateObject[{2022, 8, 4}, "Day"]]

Scope  (3)

Test whether a date is within several dates:

Wolfram Language code: DateWithinQ[{Yesterday, Today, Tomorrow}, Now]

Test whether several dates are within a given date:

Wolfram Language code: DateWithinQ[DateObject[{2022}, "Year"], {DateObject[{2022, 5, 9}, "Day"], DateObject[{2021, 8, 4}, "Day"], DateObject[{2022, 4}, "Month"]}]

Test for containment of several dates within several other dates:

Wolfram Language code: DateWithinQ[{DateObject[{2022}, "Year"], DateObject[{2021, 12}, "Month"]}, {DateObject[{2022, 6, 17}, "Day"], DateObject[{2021, 12, 25}, "Day"], Entity["Country", "SouthKorea"][EntityProperty["Country", "IndependenceDate"]]}]

Properties & Relations  (3)

DateWithinQ will return True only if date2 is entirely contained within date1:

Wolfram Language code: DateWithinQ[DateObject[{2022, 1}, "Month"], DateObject[{2022, 1, 31}, "Week"]]

DateOverlapsQ can be used to test for partial containment:

Wolfram Language code: DateOverlapsQ[DateObject[{2022, 1}, "Month"], DateObject[{2022, 1, 31}, "Week"]]

If a date object is within another, their difference will be zero of the largest calendar granularity:

Wolfram Language code: DateWithinQ[DateObject[{2022}, "Year"], DateObject[{2022, 5, 9}, "Day"]]
Wolfram Language code: DateObject[{2022, 5, 9}, "Day"] - DateObject[{2022}, "Year"]

If a date object is within another, they cannot be compared because they overlap:

Wolfram Language code: DateWithinQ[DateObject[{2023, 8}, "Month"], DateObject[{2023, 8, 4}, "Day"]]
Wolfram Language code: DateObject[{2023, 8}, "Month"] < DateObject[{2023, 8, 4}, "Day"]
Wolfram Research (2017), DateWithinQ, Wolfram Language function, https://reference.wolfram.com/language/ref/DateWithinQ.html.

Text

Wolfram Research (2017), DateWithinQ, Wolfram Language function, https://reference.wolfram.com/language/ref/DateWithinQ.html.

CMS

Wolfram Language. 2017. "DateWithinQ." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/DateWithinQ.html.

APA

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

BibTeX

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

BibLaTeX

@online{reference.wolfram_2026_datewithinq, organization={Wolfram Research}, title={DateWithinQ}, year={2017}, url={https://reference.wolfram.com/language/ref/DateWithinQ.html}, note=[Accessed: 12-June-2026]}