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 allclose all

Basic Examples  (2)

Now falls within Today:

But it does not fall within Yesterday:

Test whether a given date is within the year 2022:

Scope  (3)

Test whether a date is within several dates:

Test whether several dates are within a given date:

Test for containment of several dates within several other dates:

Properties & Relations  (3)

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

DateOverlapsQ can be used to test for partial containment:

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

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

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_2025_datewithinq, author="Wolfram Research", title="{DateWithinQ}", year="2017", howpublished="\url{https://reference.wolfram.com/language/ref/DateWithinQ.html}", note=[Accessed: 22-February-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_datewithinq, organization={Wolfram Research}, title={DateWithinQ}, year={2017}, url={https://reference.wolfram.com/language/ref/DateWithinQ.html}, note=[Accessed: 22-February-2025 ]}