ee.ImageCollection.filterDate

קיצור דרך לסינון אוסף לפי טווח תאריכים. התאריכים start ו-end יכולים להיות תאריכים, מספרים (שמתפרשים כאלפיות השנייה מאז 1970-01-01T00:00:00Z) או מחרוזות (כמו '1996-01-01T08:00'). מבוסס על 'system:time_start'.

הפעולה הזו שקולה לפעולה הזו: this.filter(ee.Filter.date(...)). אפשר לעיין בסוג ee.Filter כדי לראות אפשרויות אחרות לסינון לפי תאריך.

מחזירה את האוסף המסונן.

שימושהחזרות
ImageCollection.filterDate(start, end)אוסף
ארגומנטסוגפרטים
זה: collectionאוסףמופע האוסף.
startDate|Number|Stringתאריך ההתחלה (כולל).
endתאריך|מספר|מחרוזת, אופציונליתאריך הסיום (לא כולל). אופציונלי. אם לא מציינים את הטווח, נוצר טווח של אלפית שנייה אחת שמתחיל ב-'start'.

דוגמאות

עורך הקוד (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));

הגדרת Python

מידע על Python API ועל שימוש ב-geemap לפיתוח אינטראקטיבי מופיע בדף Python Environment.

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.
print('2020 images:', col.filterDate('2020', '2021').getInfo())
print('July images, 2020:', col.filterDate('2020-07', '2020-08').getInfo())
print('Early July images, 2020:',
      col.filterDate('2020-07-01', '2020-07-10').getInfo())
print('Include time (13 hours, July 7, 2020):',
      col.filterDate('2020-07-05T06:34:46', '2020-07-05T19:34:46').getInfo())

# Use milliseconds since Unix epoch.
print('Milliseconds inputs:',
      col.filterDate(1593967014062, 1595349419611).getInfo())

# Use ee.Date objects.
print('ee.Date inputs',
      col.filterDate(ee.Date('2020'), ee.Date('2021')).getInfo())

# Use an ee.DateRange object.
date_range = ee.DateRange('2020-07-01', '2020-07-10')
print('ee.DateRange input', col.filterDate(date_range).getInfo())