ee.Filter.date
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
مجموعه ای را بر اساس محدوده تاریخ فیلتر کنید. شروع و پایان ممکن است تاریخ، اعداد باشد
(از 1970-01-01T00:00:00Z به عنوان میلی ثانیه تفسیر می شود)، یا رشته ها (مانند '1996-01-01T08:00'). بر اساس ویژگی "system:time_start".
فیلتر ساخته شده را برمی گرداند.
| استفاده | برمی گرداند | ee.Filter.date(start, end ) | فیلتر کنید |
| استدلال | تایپ کنید | جزئیات | start | تاریخ|شماره|رشته | تاریخ شروع (شامل). |
end | تاریخ|شماره|رشته، اختیاری | تاریخ پایان (انحصاری). اختیاری. اگر مشخص نشده باشد، یک محدوده 1 میلی ثانیه ای ایجاد می شود که از "شروع" شروع می شود. |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
// 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')))); راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]
