Announcement : All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.

ee.DateRange.union

AI-generated Key Takeaways

The union method for DateRange returns a new DateRange object that includes all points from both the original DateRange and another specified DateRange .
The union method can be used with DateRange objects that overlap or do not overlap.

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

ee.DateRange.union Stay organized with collections Save and categorize content based on your preferences.

AI-generated Key Takeaways

Examples

Code Editor (JavaScript)

Colab (Python)

ee.DateRange.union