公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Number.first
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
選取第一個值的值。
| 用量 | 傳回 |
|---|
Number.first(right) | 數字 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：left | 數字 | 左側值。 |
right | 數字 | 右側值。 |
範例
程式碼編輯器 (JavaScript)
print(ee.Number(1).first(ee.Number(2))); // 1
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
print(ee.Number(1).first(ee.Number(2)).getInfo()) # 1
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003efirst()\u003c/code\u003e selects and returns the first provided value (\u003ccode\u003eleft\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eIt takes two Number arguments: \u003ccode\u003eleft\u003c/code\u003e and \u003ccode\u003eright\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe function always returns the \u003ccode\u003eleft\u003c/code\u003e value, regardless of the \u003ccode\u003eright\u003c/code\u003e value.\u003c/p\u003e\n"]]],["The `first` method, applied to a Number object, returns the value of the left-hand number. It accepts a right-hand number as an argument but prioritizes the left-hand number's value. For example, when `ee.Number(1).first(ee.Number(2))` is executed, the output is `1`. This method is available in both JavaScript and Python, with the output of the code example demonstrated in each environment.\n"],null,["# ee.Number.first\n\nSelects the value of the first value.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------|---------|\n| Number.first`(right)` | Number |\n\n| Argument | Type | Details |\n|--------------|--------|-----------------------|\n| this: `left` | Number | The left-hand value. |\n| `right` | Number | The right-hand value. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint(ee.Number(1).first(ee.Number(2))); // 1\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(ee.Number(1).first(ee.Number(2)).getInfo()) # 1\n```"]]
