ee.DateRange.union

  • DateRange.union() combines two DateRange objects, returning a new DateRange that encompasses all dates within either of the original ranges.

  • The resulting DateRange represents the union of the input date ranges, effectively expanding the overall time period covered.

  • This function is useful for consolidating or comparing time periods represented by separate DateRange objects.

 Returns a DateRange that contains all points in the union of this DateRange and another.

UsageReturns
DateRange.union(other)DateRange
ArgumentTypeDetails
this: dateRangeDateRange
otherDateRange

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)
)