公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.DateRange.contains
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如果指定日期或日期範圍位於這個日期範圍內，則傳回 true。
| 用量 | 傳回 |
|---|
DateRange.contains(other) | 布林值 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：dateRange | DateRange | |
other | 物件 | |
範例
程式碼編輯器 (JavaScript)
// A series of ee.DateRange objects.
var dateRange1 = ee.DateRange('2017-06-24', '2017-07-24');
var dateRange2 = ee.DateRange('2017-06-30', '2017-07-10');
var dateRange3 = ee.DateRange('2010-06-24', '2020-07-24');
// Determine if an ee.DateRange is contained within another.
print('Does dateRange1 contain dateRange2?', dateRange1.contains(dateRange2));
print('Does dateRange1 contain dateRange3?', dateRange1.contains(dateRange3));
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# A series of ee.DateRange objects.
date_range_1 = ee.DateRange('2017-06-24', '2017-07-24')
date_range_2 = ee.DateRange('2017-06-30', '2017-07-10')
date_range_3 = ee.DateRange('2010-06-24', '2020-07-24')
# Determine if an ee.DateRange is contained within another.
display(
'Does date_range_1 contain date_range_2?',
date_range_1.contains(date_range_2)
)
display(
'Does date_range_1 contain date_range_3?',
date_range_1.contains(date_range_3)
)
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003econtains()\u003c/code\u003e method determines if a given Date or DateRange falls entirely within another DateRange.\u003c/p\u003e\n"],["\u003cp\u003eIt returns \u003ccode\u003etrue\u003c/code\u003e if the provided Date or DateRange is fully enclosed by the target DateRange, otherwise it returns \u003ccode\u003efalse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThis method is applicable to \u003ccode\u003eee.DateRange\u003c/code\u003e objects in Earth Engine.\u003c/p\u003e\n"],["\u003cp\u003eExamples are provided in both JavaScript and Python to illustrate the usage of \u003ccode\u003econtains()\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `contains()` method checks if a given `Date` or `DateRange` falls within a specified `DateRange`. It takes an `other` object as an argument and returns a Boolean value. For example, if `dateRange1` is '2017-06-24' to '2017-07-24' and `dateRange2` is '2017-06-30' to '2017-07-10', `dateRange1.contains(dateRange2)` will return `true`. Otherwise it will return `false`. The method is used in both JavaScript and Python.\n"],null,["# ee.DateRange.contains\n\nReturns true if the given Date or DateRange is within this DateRange.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------|---------|\n| DateRange.contains`(other)` | Boolean |\n\n| Argument | Type | Details |\n|-------------------|-----------|---------|\n| this: `dateRange` | DateRange | |\n| `other` | Object | |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A series of ee.DateRange objects.\nvar dateRange1 = ee.DateRange('2017-06-24', '2017-07-24');\nvar dateRange2 = ee.DateRange('2017-06-30', '2017-07-10');\nvar dateRange3 = ee.DateRange('2010-06-24', '2020-07-24');\n\n// Determine if an ee.DateRange is contained within another.\nprint('Does dateRange1 contain dateRange2?', dateRange1.contains(dateRange2));\nprint('Does dateRange1 contain dateRange3?', dateRange1.contains(dateRange3));\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# A series of ee.DateRange objects.\ndate_range_1 = ee.DateRange('2017-06-24', '2017-07-24')\ndate_range_2 = ee.DateRange('2017-06-30', '2017-07-10')\ndate_range_3 = ee.DateRange('2010-06-24', '2020-07-24')\n\n# Determine if an ee.DateRange is contained within another.\ndisplay(\n 'Does date_range_1 contain date_range_2?',\n date_range_1.contains(date_range_2)\n)\ndisplay(\n 'Does date_range_1 contain date_range_3?',\n date_range_1.contains(date_range_3)\n)\n```"]]
