Page Summary
-
ImageCollection.filterDateis a shortcut to filter a collection by a date range based on the 'system:time_start' property. -
The start and end dates can be provided as Dates, numbers representing milliseconds since the Unix epoch, or strings in various formats.
-
The end date is optional and if not specified, the filter creates a 1-millisecond range starting at the provided start date.
-
This method returns the filtered collection.
-
Examples are provided in both JavaScript and Python demonstrating how to use
filterDatewith different input types.
This is equivalent to this.filter(ee.Filter.date(...)); see the ee.Filter type for other date filtering options.
Returns the filtered collection.
| Usage | Returns |
|---|---|
ImageCollection.
filterDate
(start, end
)
|
Collection |
| Argument | Type | Details |
|---|---|---|
|
this:
collection
|
Collection | The Collection instance. |
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)
// A Landsat 8 TOA image collection intersecting a specific point. var col = ee . ImageCollection ( 'LANDSAT/LC08/C02/T1_TOA' ) . filterBounds ( ee . Geometry . Point ( - 90.70 , 34.71 )); // Filter the collection by date using date strings. print ( '2020 images' , col . filterDate ( '2020' , '2021' )); print ( 'July images, 2020' , col . filterDate ( '2020-07' , '2020-08' )); print ( 'Early July images, 2020' , col . filterDate ( '2020-07-01' , '2020-07-10' )); print ( 'Include time (13 hours, July 7, 2020)' , col . filterDate ( '2020-07-05T06:34:46' , '2020-07-05T19:34:46' )); // Use milliseconds since Unix epoch. print ( 'Milliseconds inputs' , col . filterDate ( 1593967014062 , 1595349419611 )); // Use ee.Date objects. print ( 'ee.Date inputs' , col . filterDate ( ee . Date ( '2020' ), ee . Date ( '2021' ))); // Use an ee.DateRange object. var dateRange = ee . DateRange ( '2020-07-01' , '2020-07-10' ); print ( 'ee.DateRange input' , col . filterDate ( dateRange ));
import ee import geemap.core as geemap
Colab (Python)
# A Landsat 8 TOA image collection intersecting a specific point. col = ee . ImageCollection ( 'LANDSAT/LC08/C02/T1_TOA' ) . filterBounds ( ee . Geometry . Point ( - 90.70 , 34.71 )) # Filter the collection by date using date strings. display ( '2020 images:' , col . filterDate ( '2020' , '2021' )) display ( 'July images, 2020:' , col . filterDate ( '2020-07' , '2020-08' )) display ( 'Early July images, 2020:' , col . filterDate ( '2020-07-01' , '2020-07-10' )) display ( 'Include time (13 hours, July 7, 2020):' , col . filterDate ( '2020-07-05T06:34:46' , '2020-07-05T19:34:46' )) # Use milliseconds since Unix epoch. display ( 'Milliseconds inputs:' , col . filterDate ( 1593967014062 , 1595349419611 )) # Use ee.Date objects. display ( 'ee.Date inputs' , col . filterDate ( ee . Date ( '2020' ), ee . Date ( '2021' ))) # Use an ee.DateRange object. date_range = ee . DateRange ( '2020-07-01' , '2020-07-10' ) display ( 'ee.DateRange input' , col . filterDate ( date_range ))
