AI-generated Key Takeaways
-
The
ee.Filter.datefunction filters a collection by a specified date range based on the 'system:time_start' property. -
The
startandendarguments can be provided as Date objects, numbers representing milliseconds since the Unix epoch, or strings. -
The
enddate argument is optional, and if not provided, a 1-millisecond range starting at thestartdate is created. -
The function returns the constructed filter object.
(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' ))));
import ee import geemap.core as geemap
Colab (Python)
# 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. display ( 'Field site observations collection in July 2021:' , fc . filter ( ee . Filter . date ( '2021-07-01' , '2021-08-01' ))) # Alternative input formats. date_range = ee . DateRange ( '2021-07-01' , '2021-08-01' ) display ( fc . filter ( ee . Filter . date ( date_range ))) display ( 'Numbers (milliseconds since Unix epoch) as an input:' , fc . filter ( ee . Filter . date ( 1625875200000 , 1626739200001 ))) display ( 'ee.Date objects as an input:' , fc . filter ( ee . Filter . date ( ee . Date ( '2021-07-01' ), ee . Date ( '2021-08-01' )) ) )
