公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Number.firstNonZero
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如果第一個值不是零，則選取第一個值，否則選取第二個值。
| 用量 | 傳回 |
|---|
Number.firstNonZero(right) | 數字 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：left | 數字 | 左側值。 |
right | 數字 | 右側值。 |
範例
程式碼編輯器 (JavaScript)
print('First non-zero: 0, 5', ee.Number(0).firstNonZero(ee.Number(5))); // 5
print('First non-zero: 5, 0', ee.Number(5).firstNonZero(ee.Number(0))); // 5
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
print('First non-zero in [0, 5]:',
ee.Number(0).firstNonZero(ee.Number(5)).getInfo()) # 5
print('First non-zero in [5, 0]:',
ee.Number(5).firstNonZero(ee.Number(0)).getInfo()) # 5
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003efirstNonZero()\u003c/code\u003e is a method that selects and returns the first number if it is not zero, otherwise, it returns the second number.\u003c/p\u003e\n"],["\u003cp\u003eIt takes two arguments: the left-hand value (\u003ccode\u003ethis: left\u003c/code\u003e) and the right-hand value (\u003ccode\u003eright\u003c/code\u003e), both of which should be of type Number.\u003c/p\u003e\n"],["\u003cp\u003eThis function can be useful for conditional selections where a fallback value is needed if the primary value is zero.\u003c/p\u003e\n"]]],["The `firstNonZero` method, applied to a number (`left`), takes another number (`right`) as an argument. It returns the `left` value if it's non-zero; otherwise, it returns the `right` value. The method is available in both JavaScript and Python, operating on numerical data. Examples show that `firstNonZero` selects 5 when given (0, 5) or (5, 0) as inputs.\n"],null,["# ee.Number.firstNonZero\n\nSelects the first value if it is non-zero, and the second value otherwise.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------|---------|\n| Number.firstNonZero`(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('First non-zero: 0, 5', ee.Number(0).firstNonZero(ee.Number(5))); // 5\nprint('First non-zero: 5, 0', ee.Number(5).firstNonZero(ee.Number(0))); // 5\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('First non-zero in [0, 5]:',\n ee.Number(0).firstNonZero(ee.Number(5)).getInfo()) # 5\nprint('First non-zero in [5, 0]:',\n ee.Number(5).firstNonZero(ee.Number(0)).getInfo()) # 5\n```"]]
