公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
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 | 集合 | Collection 实例。 |
start | 日期|数字|字符串 | 开始日期(含)。 |
end | Date|Number|String,可选 | 结束日期(不含)。可选。如果未指定,则会创建一个从“start”开始的 1 毫秒范围。 |
示例
代码编辑器 (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 API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
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())
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003efilterDate()\u003c/code\u003e allows you to filter a FeatureCollection by a 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 epoch), or strings.\u003c/p\u003e\n"],["\u003cp\u003eThe end date is exclusive, and if not specified, a 1-millisecond range starting at the start date is used.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efilterDate()\u003c/code\u003e is equivalent to using \u003ccode\u003eee.Filter.date()\u003c/code\u003e and is a convenient shortcut for temporal filtering.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.filterDate\n\n\u003cbr /\u003e\n\nShortcut to filter a collection by a date range. The start and end may be Dates, numbers (interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). Based on 'system:time_start'.\n\n\u003cbr /\u003e\n\nThis is equivalent to this.filter(ee.Filter.date(...)); see the ee.Filter type for other date filtering options.\n\nReturns the filtered collection.\n\n| Usage | Returns |\n|------------------------------------------------|------------|\n| FeatureCollection.filterDate`(start, `*end*`)` | Collection |\n\n| Argument | Type | Details |\n|--------------------|--------------------------------|-------------------------------------------------------------------------------------------------------------|\n| this: `collection` | Collection | The Collection instance. |\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// Constructed FeatureCollection representing a field site sampled at\n// four different dates; date recorded as \"system:time_start\" property in units\n// of milliseconds since Unix epoch.\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.filterDate('2021-07-01', '2021-08-01'));\n\n// Alternative input formats.\nprint('ee.DateRange as an input',\n fc.filterDate(ee.DateRange('2021-07-01', '2021-08-01')));\n\nprint('Numbers (milliseconds since Unix epoch) as an input',\n fc.filterDate(1625875200000, 1626739200001));\n\nprint('ee.Date objects as an input',\n fc.filterDate(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\n# Constructed FeatureCollection representing a field site sampled at\n# four different dates; date recorded as \"system:time_start\" property in units\n# of milliseconds since Unix epoch.\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:',\n fc.filterDate('2021-07-01', '2021-08-01').getInfo())\n\n# Alternative input formats.\nprint('ee.DateRange as an input:',\n fc.filterDate(ee.DateRange('2021-07-01', '2021-08-01')).getInfo())\n\nprint('Numbers (milliseconds since Unix epoch) as an input:',\n fc.filterDate(1625875200000, 1626739200001).getInfo())\n\nprint('ee.Date objects as an input:',\n fc.filterDate(ee.Date('2021-07-01'), ee.Date('2021-08-01')).getInfo())\n```"]]