إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Filter.date
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
فلترة مجموعة حسب النطاق الزمني قد تكون البداية والنهاية تواريخ أو أرقامًا
(يتم تفسيرها على أنّها ملي ثانية منذ 1970-01-01T00:00:00Z)، أو سلاسل (مثل '1996-01-01T08:00'). استنادًا إلى السمة "system:time_start"
تعرض هذه الدالة الفلتر الذي تم إنشاؤه.
الاستخدام | المرتجعات |
---|
ee.Filter.date(start, end) | تصفية |
الوسيطة | النوع | التفاصيل |
---|
start | Date|Number|String | تاريخ البدء (شامل) |
end | التاريخ|الرقم|السلسلة، اختياري | تاريخ الانتهاء (حصري) اختيارية: في حال عدم تحديدها، يتم إنشاء نطاق مدته جزء من الألف من الثانية يبدأ من "البداية". |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// collection.filterDate is preferred.
// Constructed FeatureCollection representing a field site sampled at
// four different dates.
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.filter(ee.Filter.date('2021-07-01', '2021-08-01')));
// Alternative input formats.
var dateRange = ee.DateRange('2021-07-01', '2021-08-01');
print('ee.DateRange as an input',
fc.filter(ee.Filter.date(dateRange)));
print('Numbers (milliseconds since Unix epoch) as an input',
fc.filter(ee.Filter.date(1625875200000, 1626739200001)));
print('ee.Date objects as an input',
fc.filter(ee.Filter.date(ee.Date('2021-07-01'), ee.Date('2021-08-01'))));
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
from pprint import pprint
# collection.filterDate is preferred.
# Constructed FeatureCollection representing a field site sampled at
# four different dates.
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:')
pprint(fc.filter(ee.Filter.date('2021-07-01', '2021-08-01')).getInfo())
# Alternative input formats.
date_range = ee.DateRange('2021-07-01', '2021-08-01')
pprint(fc.filter(ee.Filter.date(date_range)).getInfo())
print('Numbers (milliseconds since Unix epoch) as an input:')
pprint(fc.filter(ee.Filter.date(1625875200000, 1626739200001)).getInfo())
print('ee.Date objects as an input:')
pprint(
fc.filter(
ee.Filter.date(ee.Date('2021-07-01'), ee.Date('2021-08-01'))
).getInfo()
)
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eee.Filter.date\u003c/code\u003e filters a collection by date range based on the \u003ccode\u003esystem:time_start\u003c/code\u003e property.\u003c/p\u003e\n"],["\u003cp\u003eThe start and end dates can be specified as Dates, numbers (milliseconds since 1970-01-01T00:00:00Z), or strings (like 'YYYY-MM-DDTHH:mm').\u003c/p\u003e\n"],["\u003cp\u003eThe end date is exclusive, and if omitted, a 1-millisecond range starting at the start date is used.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eee.Filter.date\u003c/code\u003e returns a filter that can be applied to a collection using the \u003ccode\u003efilter\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The core functionality is filtering a collection based on a date range, using the `system:time_start` property. The `ee.Filter.date(start, end)` method facilitates this, accepting `start` and optional `end` arguments as Dates, numbers (milliseconds since 1970), or strings (e.g., '1996-01-01'). If `end` is omitted, a 1-millisecond range is created. The method returns a filter, allowing users to filter collections. The code shows various ways of using this filter.\n"],null,["# ee.Filter.date\n\n\u003cbr /\u003e\n\nFilter a collection by date range. The start and end may be Dates, numbers\n\n\u003cbr /\u003e\n\n(interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). Based on 'system:time_start' property.\n\nReturns the constructed filter.\n\n| Usage | Returns |\n|----------------------------------|---------|\n| `ee.Filter.date(start, `*end*`)` | Filter |\n\n| Argument | Type | Details |\n|----------|--------------------------------|-------------------------------------------------------------------------------------------------------------|\n| `start` | Date\\|Number\\|String | The start date (inclusive). |\n| `end` | Date\\|Number\\|String, optional | The end date (exclusive). Optional. If not specified, a 1-millisecond range starting at 'start' is created. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// collection.filterDate is preferred.\n// Constructed FeatureCollection representing a field site sampled at\n// four different dates.\nvar geom = ee.Geometry.Point([-119.56, 37.67]);\nvar fc = ee.FeatureCollection([\n ee.Feature(geom, {'prop': 10, 'system:time_start': ee.Date('2021-06-10')}),\n ee.Feature(geom, {'prop': 11, 'system:time_start': ee.Date('2021-06-20')}),\n ee.Feature(geom, {'prop': 19, 'system:time_start': ee.Date('2021-07-10')}),\n ee.Feature(geom, {'prop': 10, 'system:time_start': ee.Date('2021-07-20')})\n]);\n\n// Filter the observations in July 2021.\nprint('Field site observations collection in July 2021',\n fc.filter(ee.Filter.date('2021-07-01', '2021-08-01')));\n\n// Alternative input formats.\nvar dateRange = ee.DateRange('2021-07-01', '2021-08-01');\nprint('ee.DateRange as an input',\n fc.filter(ee.Filter.date(dateRange)));\n\nprint('Numbers (milliseconds since Unix epoch) as an input',\n fc.filter(ee.Filter.date(1625875200000, 1626739200001)));\n\nprint('ee.Date objects as an input',\n fc.filter(ee.Filter.date(ee.Date('2021-07-01'), ee.Date('2021-08-01'))));\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nfrom pprint import pprint\n\n# collection.filterDate is preferred.\n# Constructed FeatureCollection representing a field site sampled at\n# four different dates.\ngeom = ee.Geometry.Point([-119.56, 37.67])\nfc = ee.FeatureCollection([\n ee.Feature(geom, {'prop': 10, 'system:time_start': ee.Date('2021-06-10')}),\n ee.Feature(geom, {'prop': 11, 'system:time_start': ee.Date('2021-06-20')}),\n ee.Feature(geom, {'prop': 19, 'system:time_start': ee.Date('2021-07-10')}),\n ee.Feature(geom, {'prop': 10, 'system:time_start': ee.Date('2021-07-20')})\n])\n\n# Filter the observations in July 2021.\nprint('Field site observations collection in July 2021:')\npprint(fc.filter(ee.Filter.date('2021-07-01', '2021-08-01')).getInfo())\n\n# Alternative input formats.\ndate_range = ee.DateRange('2021-07-01', '2021-08-01')\npprint(fc.filter(ee.Filter.date(date_range)).getInfo())\n\nprint('Numbers (milliseconds since Unix epoch) as an input:')\npprint(fc.filter(ee.Filter.date(1625875200000, 1626739200001)).getInfo())\n\nprint('ee.Date objects as an input:')\npprint(\n fc.filter(\n ee.Filter.date(ee.Date('2021-07-01'), ee.Date('2021-08-01'))\n ).getInfo()\n)\n```"]]