ee.ImageCollection.filterDate

اختصار لفلترة مجموعة حسب نطاق زمني يمكن أن تكون البداية والنهاية تواريخًا أو أرقامًا (يتم تفسيرها على أنّها أجزاء من الألف من الثانية منذ 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التاريخ|الرقم|السلسلة، اختياريتاريخ الانتهاء (حصري) اختيارية: في حال عدم تحديدها، يتم إنشاء نطاق مدته جزء من الألف من الثانية يبدأ من "البداية".

أمثلة

محرّر الرموز البرمجية (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 للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام geemap للتطوير التفاعلي.

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())