公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.DateRange
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
使用给定的开始时间(含)和结束时间(不含)创建 DateRange,开始时间和结束时间可以是日期、数字(解释为自 1970-01-01T00:00:00Z 以来的毫秒数)或字符串(例如“1996-01-01T08:00”)。如果未指定“end”,则系统会创建一个从“start”开始的 1 毫秒范围。
用法 | 返回 |
---|
ee.DateRange(start, end, timeZone) | DateRange |
参数 | 类型 | 详细信息 |
---|
start | 对象 | |
end | 对象,默认值:null | |
timeZone | 字符串,默认值:null | 如果 start 和/或 end 以字符串形式提供,则用于解读这些字符串的时区;默认为 UTC。 |
示例
代码编辑器 (JavaScript)
print('String date inputs (interpreted as UTC by default)',
ee.DateRange('2017-06-24', '2017-07-24'));
print('String date inputs with timeZone argument',
ee.DateRange('2017-06-24', '2017-07-24', 'America/Los_Angeles'));
print('String date-time inputs with timeZone argument',
ee.DateRange('2017-06-24T07:00:00', '2017-07-24T07:00:00',
'America/Los_Angeles'));
print('A single date input results in a 1-millisecond range',
ee.DateRange('2017-06-24'));
print('ee.Date inputs',
ee.DateRange(ee.Date('2017-06-24'), ee.Date('2017-07-24')));
print('ee.Date date-time inputs (UTC by default)',
ee.DateRange(ee.Date('2017-06-24T07:00:00'),
ee.Date('2017-07-24T07:00:00')));
print('ee.Date date-time inputs with timeZone arguments',
ee.DateRange(ee.Date('2017-06-24T07:00:00', 'UTC'),
ee.Date('2017-07-24T07:00:00', 'America/Los_Angeles')));
print('Number inputs as milliseconds from Unix epoch (2017-06-24, 2017-07-24)',
ee.DateRange(1498262400000, 1500854400000));
Python 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
print('String date inputs (interpreted as UTC by default):',
ee.DateRange('2017-06-24', '2017-07-24').getInfo())
print('String date inputs with timeZone argument:',
ee.DateRange('2017-06-24', '2017-07-24', 'America/Los_Angeles').getInfo())
print('String date-time inputs with timeZone argument:',
ee.DateRange('2017-06-24T07:00:00', '2017-07-24T07:00:00',
'America/Los_Angeles').getInfo())
print('A single date input results in a 1-millisecond range:',
ee.DateRange('2017-06-24').getInfo())
print('ee.Date inputs',
ee.DateRange(ee.Date('2017-06-24'), ee.Date('2017-07-24')).getInfo())
print('ee.Date date-time inputs (UTC by default):',
ee.DateRange(ee.Date('2017-06-24T07:00:00'),
ee.Date('2017-07-24T07:00:00')).getInfo())
print('ee.Date date-time inputs with timeZone arguments:',
ee.DateRange(ee.Date('2017-06-24T07:00:00', 'UTC'),
ee.Date('2017-07-24T07:00:00',
'America/Los_Angeles')).getInfo())
print('Number inputs as milliseconds from Unix epoch (2017-06-24, 2017-07-24):',
ee.DateRange(1498262400000, 1500854400000).getInfo())
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eee.DateRange\u003c/code\u003e creates a range of dates, allowing you to specify a start and end date (inclusive and exclusive, respectively).\u003c/p\u003e\n"],["\u003cp\u003eStart and end dates can be provided as Dates, numbers (milliseconds since epoch), or strings (e.g., 'YYYY-MM-DD' or 'YYYY-MM-DDTHH:mm:ss').\u003c/p\u003e\n"],["\u003cp\u003eIf only a start date is given, a 1-millisecond range is created starting at that date.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the time zone for string inputs using the optional \u003ccode\u003etimeZone\u003c/code\u003e argument, which defaults to UTC.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eee.DateRange\u003c/code\u003e is essential for temporal filtering and analysis in Earth Engine.\u003c/p\u003e\n"]]],[],null,["# ee.DateRange\n\nCreates a DateRange with the given start (inclusive) and end (exclusive), which may be Dates, numbers (interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). If 'end' is not specified, a 1-millisecond range starting at 'start' is created.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------|-----------|\n| `ee.DateRange(start, `*end* `, `*timeZone*`)` | DateRange |\n\n| Argument | Type | Details |\n|------------|-----------------------|---------------------------------------------------------------------------------------------------------|\n| `start` | Object | |\n| `end` | Object, default: null | |\n| `timeZone` | String, default: null | If start and/or end are provided as strings, the time zone in which to interpret them; defaults to UTC. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint('String date inputs (interpreted as UTC by default)',\n ee.DateRange('2017-06-24', '2017-07-24'));\n\nprint('String date inputs with timeZone argument',\n ee.DateRange('2017-06-24', '2017-07-24', 'America/Los_Angeles'));\n\nprint('String date-time inputs with timeZone argument',\n ee.DateRange('2017-06-24T07:00:00', '2017-07-24T07:00:00',\n 'America/Los_Angeles'));\n\nprint('A single date input results in a 1-millisecond range',\n ee.DateRange('2017-06-24'));\n\nprint('ee.Date inputs',\n ee.DateRange(ee.Date('2017-06-24'), ee.Date('2017-07-24')));\n\nprint('ee.Date date-time inputs (UTC by default)',\n ee.DateRange(ee.Date('2017-06-24T07:00:00'),\n ee.Date('2017-07-24T07:00:00')));\n\nprint('ee.Date date-time inputs with timeZone arguments',\n ee.DateRange(ee.Date('2017-06-24T07:00:00', 'UTC'),\n ee.Date('2017-07-24T07:00:00', 'America/Los_Angeles')));\n\nprint('Number inputs as milliseconds from Unix epoch (2017-06-24, 2017-07-24)',\n ee.DateRange(1498262400000, 1500854400000));\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\nprint('String date inputs (interpreted as UTC by default):',\n ee.DateRange('2017-06-24', '2017-07-24').getInfo())\n\nprint('String date inputs with timeZone argument:',\n ee.DateRange('2017-06-24', '2017-07-24', 'America/Los_Angeles').getInfo())\n\nprint('String date-time inputs with timeZone argument:',\n ee.DateRange('2017-06-24T07:00:00', '2017-07-24T07:00:00',\n 'America/Los_Angeles').getInfo())\n\nprint('A single date input results in a 1-millisecond range:',\n ee.DateRange('2017-06-24').getInfo())\n\nprint('ee.Date inputs',\n ee.DateRange(ee.Date('2017-06-24'), ee.Date('2017-07-24')).getInfo())\n\nprint('ee.Date date-time inputs (UTC by default):',\n ee.DateRange(ee.Date('2017-06-24T07:00:00'),\n ee.Date('2017-07-24T07:00:00')).getInfo())\n\nprint('ee.Date date-time inputs with timeZone arguments:',\n ee.DateRange(ee.Date('2017-06-24T07:00:00', 'UTC'),\n ee.Date('2017-07-24T07:00:00',\n 'America/Los_Angeles')).getInfo())\n\nprint('Number inputs as milliseconds from Unix epoch (2017-06-24, 2017-07-24):',\n ee.DateRange(1498262400000, 1500854400000).getInfo())\n```"]]