WOLFRAM

Wolfram Language & System Documentation Center

DateBounds[{date1,date2,…}]

gives the earliest and latest of the datei.

DateBounds[obj]

gives the start and end dates associated with a given data object obj.

DateBounds[obj,gran]

gives the endpoints of interval in the specified granularity gran.

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

DateBounds

DateBounds[{date1,date2,…}]

gives the earliest and latest of the datei.

DateBounds[obj]

gives the start and end dates associated with a given data object obj.

DateBounds[obj,gran]

gives the endpoints of interval in the specified granularity gran.

Details

Examples

open all close all

Basic Examples  (3)

Find the first and last dates in a list of date objects:

Wolfram Language code: DateBounds[{DateObject[{2022, 4, 8}, "Day"], DateObject[{2022, 4, 9}, "Day"], DateObject[{2022, 4, 7}, "Day"]}]

Find the first and last dates associated with a DateInterval:

Wolfram Language code: DateBounds[DateInterval[{DateObject[{2025, 8, 24}, "Day"], DateObject[{2025, 8, 25, 13, 47, 31.169890}, "Instant", "Gregorian", -5.]}]]

Find the temporal bounds of a TimeSeries as "Day" granular objects:

Wolfram Language code: ts = FinancialData["NYSE:GE", DateObject[{2020, 1, 1}, "Day"]]
Wolfram Language code: DateBounds[ts, "Day"]

Scope  (4)

Find the first and last dates in a list of dates in different forms:

Wolfram Language code: DateBounds[{DateObject[{2022}], "1950 Jan 4th", 3867285330, {2023, 1, 1}}]

Find the temporal bounds of an EventSeries:

Wolfram Language code: es = EarthquakeData[All, 8, {{2020, 1, 1}, {2022, 5, 16}}, "Magnitude"]
Wolfram Language code: DateBounds[es]

Find the temporal bounds of a Databin:

Wolfram Language code: bin = Databin["1qGFQ8v"]
Wolfram Language code: DateBounds[bin]

If only one date is given in the input, it will be returned as the first and last date:

Wolfram Language code: DateBounds[{Today}]

Properties & Relations  (5)

DateBounds returns the Min and Max associated with a list of DateObject expressions:

Wolfram Language code: dates = {DateObject[{2021, 8, 4}, "Day"], DateObject[{2007, 1, 5}, "Day"], DateObject[{2024, 10, 13}, "Day"], DateObject[{2020, 12, 23}, "Day"]};
Wolfram Language code: DateBounds[dates]
Wolfram Language code: Min[dates]
Wolfram Language code: Max[dates]

MinMax returns the same results as DateBounds if the input is a list of date objects:

Wolfram Language code: dates = {DateObject[{2021, 8, 4}, "Day"], DateObject[{2007, 1, 5}, "Day"], DateObject[{2024, 10, 13}, "Day"], DateObject[{2020, 12, 23}, "Day"]};
Wolfram Language code: MinMax[dates]

DateBounds[ts] returns the dates corresponding to ts["FirstDate"] and ts["LastDate"]:

Wolfram Language code: moon = MoonPosition[DateRange[DateObject[{2022, 1, 1}], DateObject[{2022, 1, 31}], 1]]
Wolfram Language code: DateBounds[moon]
Wolfram Language code: moon["FirstDate"]
Wolfram Language code: moon["LastDate"]

These are also the Min and Max values of ts["DateList"]:

Wolfram Language code: MinMax[moon["DateList"]]

DateBounds[bin] returns the dates corresponding to bin["TimeInterval"]:

Wolfram Language code: bin = Databin["2akVuNN2"]
Wolfram Language code: DateBounds[bin]
Wolfram Language code: bin["TimeInterval"]

These are also the Min and Max values of bin["Timestamps"]:

Wolfram Language code: MinMax[bin["Timestamps"]]

DateBounds accounts for differences in TimeZone when determining the first and last date:

Wolfram Language code: DateBounds[{DateObject[{2022, 5, 10, 15, 52}, "Minute", "Gregorian", -4.], DateObject[{2022, 5, 2, 15, 52}, "Minute", "Gregorian", 0.], DateObject[{2022, 5, 5, 15, 52}, "Minute", "Gregorian", -7.]}]

For dates that are not a DateObject, $TimeZone is assumed:

Wolfram Language code: DateBounds[{DateObject[{2022, 5, 10, 15, 52}, "Minute", "Gregorian", -4.], DateObject[{2022, 5, 2, 15, 52}, "Minute", "Gregorian", 0.], DateObject[{2022, 5, 5, 15, 52}, "Minute", "Gregorian", -7.], "May 10th, 2022 16:00"}]
Wolfram Language code: Block[{$TimeZone = 0}, DateBounds[{DateObject[{2022, 5, 10, 15, 52}, "Minute", "Gregorian", -4.], DateObject[{2022, 5, 2, 15, 52}, "Minute", "Gregorian", 0.], DateObject[{2022, 5, 5, 15, 52}, "Minute", "Gregorian", -7.], "May 10th, 2022 16:00"}] ]

Neat Examples  (1)

Compare the date bounds associated with different databins:

Wolfram Language code: bins = { Databin["3wq7Nk7W"], Databin["2akVuNN2"], Databin["2anlZF8U"], Databin["2anHvIz1"] };
Wolfram Language code: dates = DateBounds /@ bins

Visualize the overlap between databins using TimelinePlot:

Wolfram Language code: TimelinePlot[Interval /@ dates]
Wolfram Research (2016), DateBounds, Wolfram Language function, https://reference.wolfram.com/language/ref/DateBounds.html (updated 2020).

Text

Wolfram Research (2016), DateBounds, Wolfram Language function, https://reference.wolfram.com/language/ref/DateBounds.html (updated 2020).

CMS

Wolfram Language. 2016. "DateBounds." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/DateBounds.html.

APA

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

BibTeX

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

BibLaTeX

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