ee.Filter.date

Filter a collection by date range. The start and end may be Dates, numbers

(interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). Based on 'system:time_start' property.

Returns the constructed filter.

Usage Returns
ee.Filter.date(start, end ) Filter
Argument Type Details
start
Date|Number|String The start date (inclusive).
end
Date|Number|String, optional The end date (exclusive). Optional. If not specified, a 1-millisecond range starting at 'start' is created.

Examples

Code Editor (JavaScript)

 // collection.filterDate is preferred. 
 // Constructed FeatureCollection representing a field site sampled at 
 // four different dates. 
 var 
  
 geom 
  
 = 
  
 ee 
 . 
 Geometry 
 . 
 Point 
 ([ 
 - 
 119.56 
 , 
  
 37.67 
 ]); 
 var 
  
 fc 
  
 = 
  
 ee 
 . 
 FeatureCollection 
 ([ 
  
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
  
 { 
 'prop' 
 : 
  
 10 
 , 
  
 'system:time_start' 
 : 
  
 ee 
 . 
 Date 
 ( 
 '2021-06-10' 
 )}), 
  
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
  
 { 
 'prop' 
 : 
  
 11 
 , 
  
 'system:time_start' 
 : 
  
 ee 
 . 
 Date 
 ( 
 '2021-06-20' 
 )}), 
  
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
  
 { 
 'prop' 
 : 
  
 19 
 , 
  
 'system:time_start' 
 : 
  
 ee 
 . 
 Date 
 ( 
 '2021-07-10' 
 )}), 
  
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
  
 { 
 'prop' 
 : 
  
 10 
 , 
  
 'system:time_start' 
 : 
  
 ee 
 . 
 Date 
 ( 
 '2021-07-20' 
 )}) 
 ]); 
 // Filter the observations in July 2021. 
 print 
 ( 
 'Field site observations collection in July 2021' 
 , 
  
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 '2021-07-01' 
 , 
  
 '2021-08-01' 
 ))); 
 // Alternative input formats. 
 var 
  
 dateRange 
  
 = 
  
 ee 
 . 
 DateRange 
 ( 
 '2021-07-01' 
 , 
  
 '2021-08-01' 
 ); 
 print 
 ( 
 'ee.DateRange as an input' 
 , 
  
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 dateRange 
 ))); 
 print 
 ( 
 'Numbers (milliseconds since Unix epoch) as an input' 
 , 
  
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 1625875200000 
 , 
  
 1626739200001 
 ))); 
 print 
 ( 
 'ee.Date objects as an input' 
 , 
  
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 ee 
 . 
 Date 
 ( 
 '2021-07-01' 
 ), 
  
 ee 
 . 
 Date 
 ( 
 '2021-08-01' 
 )))); 

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)

 from 
  
 pprint 
  
 import 
 pprint 
 # collection.filterDate is preferred. 
 # Constructed FeatureCollection representing a field site sampled at 
 # four different dates. 
 geom 
 = 
 ee 
 . 
 Geometry 
 . 
 Point 
 ([ 
 - 
 119.56 
 , 
 37.67 
 ]) 
 fc 
 = 
 ee 
 . 
 FeatureCollection 
 ([ 
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
 { 
 'prop' 
 : 
 10 
 , 
 'system:time_start' 
 : 
 ee 
 . 
 Date 
 ( 
 '2021-06-10' 
 )}), 
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
 { 
 'prop' 
 : 
 11 
 , 
 'system:time_start' 
 : 
 ee 
 . 
 Date 
 ( 
 '2021-06-20' 
 )}), 
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
 { 
 'prop' 
 : 
 19 
 , 
 'system:time_start' 
 : 
 ee 
 . 
 Date 
 ( 
 '2021-07-10' 
 )}), 
 ee 
 . 
 Feature 
 ( 
 geom 
 , 
 { 
 'prop' 
 : 
 10 
 , 
 'system:time_start' 
 : 
 ee 
 . 
 Date 
 ( 
 '2021-07-20' 
 )}) 
 ]) 
 # Filter the observations in July 2021. 
 print 
 ( 
 'Field site observations collection in July 2021:' 
 ) 
 pprint 
 ( 
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 '2021-07-01' 
 , 
 '2021-08-01' 
 )) 
 . 
 getInfo 
 ()) 
 # Alternative input formats. 
 date_range 
 = 
 ee 
 . 
 DateRange 
 ( 
 '2021-07-01' 
 , 
 '2021-08-01' 
 ) 
 pprint 
 ( 
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 date_range 
 )) 
 . 
 getInfo 
 ()) 
 print 
 ( 
 'Numbers (milliseconds since Unix epoch) as an input:' 
 ) 
 pprint 
 ( 
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 1625875200000 
 , 
 1626739200001 
 )) 
 . 
 getInfo 
 ()) 
 print 
 ( 
 'ee.Date objects as an input:' 
 ) 
 pprint 
 ( 
 fc 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 date 
 ( 
 ee 
 . 
 Date 
 ( 
 '2021-07-01' 
 ), 
 ee 
 . 
 Date 
 ( 
 '2021-08-01' 
 )) 
 ) 
 . 
 getInfo 
 () 
 ) 
Create a Mobile Website
View Site in Mobile | Classic
Share by: