Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.DateRange.union
Stay organized with collections
Save and categorize content based on your preferences.
Returns a DateRange that contains all points in the union of this DateRange and another.
| Usage | Returns | DateRange.union(other) | DateRange |
| Argument | Type | Details | this: dateRange | DateRange | |
other | DateRange | |
Examples
Code Editor (JavaScript)
// A series of ee.DateRange objects.
var dateRange1 = ee.DateRange('2017-06-24', '2017-07-24');
var dateRange2 = ee.DateRange('2017-06-30', '2018-07-10');
var dateRange3 = ee.DateRange('1970-06-24', '1971-07-24');
// Determine the union of ee.DateRange objects.
print('Union of dateRange1 and dateRange2, which overlap',
dateRange1.union(dateRange2));
print('Union of dateRange1 and dateRange3, which do not overlap',
dateRange1.union(dateRange3));
Python setup
See the
Python Environment page for information on the Python API and using
geemap for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# A series of ee.DateRange objects.
date_range_1 = ee.DateRange('2017-06-24', '2017-07-24')
date_range_2 = ee.DateRange('2017-06-30', '2018-07-10')
date_range_3 = ee.DateRange('1970-06-24', '1971-07-24')
# Determine the union of ee.DateRange objects.
display(
'Union of date_range_1 and date_range_2, which overlap:',
date_range_1.union(date_range_2)
)
display(
'Union of date_range_1 and date_range_3, which do not overlap:',
date_range_1.union(date_range_3)
)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eDateRange.union()\u003c/code\u003e combines two \u003ccode\u003eDateRange\u003c/code\u003e objects, returning a new \u003ccode\u003eDateRange\u003c/code\u003e that encompasses all dates within either of the original ranges.\u003c/p\u003e\n"],["\u003cp\u003eThe resulting \u003ccode\u003eDateRange\u003c/code\u003e represents the union of the input date ranges, effectively expanding the overall time period covered.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for consolidating or comparing time periods represented by separate \u003ccode\u003eDateRange\u003c/code\u003e objects.\u003c/p\u003e\n"]]],["The `DateRange.union(other)` method combines two `DateRange` objects, returning a new `DateRange` that encompasses all dates within both original ranges. It accepts another `DateRange` as an argument. The examples demonstrate this function in both JavaScript and Python, by uniting overlapping and non-overlapping date ranges, illustrating the creation of a single `DateRange` that covers the entire temporal extent of the combined inputs.\n"],null,["# ee.DateRange.union\n\nReturns a DateRange that contains all points in the union of this DateRange and another.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------------|-----------|\n| DateRange.union`(other)` | DateRange |\n\n| Argument | Type | Details |\n|-------------------|-----------|---------|\n| this: `dateRange` | DateRange | |\n| `other` | DateRange | |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A series of ee.DateRange objects.\nvar dateRange1 = ee.DateRange('2017-06-24', '2017-07-24');\nvar dateRange2 = ee.DateRange('2017-06-30', '2018-07-10');\nvar dateRange3 = ee.DateRange('1970-06-24', '1971-07-24');\n\n// Determine the union of ee.DateRange objects.\nprint('Union of dateRange1 and dateRange2, which overlap',\n dateRange1.union(dateRange2));\nprint('Union of dateRange1 and dateRange3, which do not overlap',\n dateRange1.union(dateRange3));\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# A series of ee.DateRange objects.\ndate_range_1 = ee.DateRange('2017-06-24', '2017-07-24')\ndate_range_2 = ee.DateRange('2017-06-30', '2018-07-10')\ndate_range_3 = ee.DateRange('1970-06-24', '1971-07-24')\n\n# Determine the union of ee.DateRange objects.\ndisplay(\n 'Union of date_range_1 and date_range_2, which overlap:',\n date_range_1.union(date_range_2)\n)\ndisplay(\n 'Union of date_range_1 and date_range_3, which do not overlap:',\n date_range_1.union(date_range_3)\n)\n```"]]