ee.FeatureCollection.filterDate

اختصار لفلترة مجموعة حسب نطاق زمني يمكن أن تكون البداية والنهاية تواريخًا أو أرقامًا (يتم تفسيرها على أنّها أجزاء من الألف من الثانية منذ 1970-01-01T00:00:00Z) أو سلاسل (مثل '1996-01-01T08:00'). استنادًا إلى 'system:time_start'.

وهذا يعادل this.filter(ee.Filter.date(...))؛ راجِع نوع ee.Filter للاطّلاع على خيارات أخرى لفلترة التاريخ.

تعرض هذه السمة المجموعة التي تمت فلترتها.

الاستخدامالمرتجعات
FeatureCollection.filterDate(start, end)مجموعة
الوسيطةالنوعالتفاصيل
هذا: collectionمجموعةمثيل المجموعة
startDate|Number|Stringتاريخ البدء (شامل)
endالتاريخ|الرقم|السلسلة، اختياريتاريخ الانتهاء (حصري) اختيارية: في حال عدم تحديدها، يتم إنشاء نطاق مدته جزء من الألف من الثانية يبدأ من "البداية".

أمثلة

محرّر الرموز البرمجية (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')));

إعداد Python

راجِع صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام geemap للتطوير التفاعلي.

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.
print('Field site observations collection in July 2021:',
      fc.filterDate('2021-07-01', '2021-08-01').getInfo())

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

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

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