ee.FeatureCollection.filterDate

Raccourci permettant de filtrer une collection par plage de dates. Le début et la fin peuvent être des dates, des nombres (interprétés comme des millisecondes depuis 1970-01-01T00:00:00Z) ou des chaînes (telles que "1996-01-01T08:00"). Basé sur "system:time_start".

Cela équivaut à this.filter(ee.Filter.date(...)). Consultez le type ee.Filter pour d'autres options de filtrage par date.

Renvoie la collection filtrée.

UtilisationRenvoie
FeatureCollection.filterDate(start, end)Collection
ArgumentTypeDétails
ceci : collectionCollectionInstance de la collection.
startDate|Nombre|ChaîneDate de début (incluse).
endDate|Nombre|Chaîne, facultatifDate de fin (exclusive). Facultatif. Si aucune n'est spécifiée, une plage d'une milliseconde commençant à "start" est créée.

Exemples

Éditeur de code (JavaScript)

// Constructed FeatureCollection representing a field site sampled at
// four different dates; date recorded as "system:time_start" property in units
// of milliseconds since Unix epoch.
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.filterDate('2021-07-01', '2021-08-01'));

// Alternative input formats.
print('ee.DateRange as an input',
      fc.filterDate(ee.DateRange('2021-07-01', '2021-08-01')));

print('Numbers (milliseconds since Unix epoch) as an input',
      fc.filterDate(1625875200000, 1626739200001));

print('ee.Date objects as an input',
      fc.filterDate(ee.Date('2021-07-01'), ee.Date('2021-08-01')));

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.

import ee
import geemap.core as geemap

Colab (Python)

# Constructed FeatureCollection representing a field site sampled at
# four different dates; date recorded as "system:time_start" property in units
# of milliseconds since Unix epoch.
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.filterDate('2021-07-01', '2021-08-01'))

# Alternative input formats.
display('ee.DateRange as an input:',
        fc.filterDate(ee.DateRange('2021-07-01', '2021-08-01')))

display('Numbers (milliseconds since Unix epoch) as an input:',
        fc.filterDate(1625875200000, 1626739200001))

display('ee.Date objects as an input:',
        fc.filterDate(ee.Date('2021-07-01'), ee.Date('2021-08-01')))