公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Number.mod
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
計算第一個值除以第二個值所得的餘數。
| 引數 | 類型 | 詳細資料 |
|---|
這個：left | 數字 | 左側值。 |
right | 數字 | 右側值。 |
範例
程式碼編輯器 (JavaScript)
// Remainder with positive dividend.
print('Remainder of 12/5', ee.Number(12).mod(ee.Number(5))); // 2
print('Remainder of 1/-2', ee.Number(1).mod(ee.Number(-2))); // 1
print('Remainder of 1/2', ee.Number(1).mod(ee.Number(2))); // 1
print('Remainder of 2/3', ee.Number(2).mod(ee.Number(3))); // 2
print('Remainder of 5.5/2', ee.Number(5.5).mod(ee.Number(2))); // 1.5
// Remainder with negative dividend.
print('Remainder of -12/5', ee.Number(-12).mod(ee.Number(5))); // -2
print('Remainder of -1/2', ee.Number(-1).mod(ee.Number(2))); // -1
print('Remainder of -4/2', ee.Number(-4).mod(ee.Number(2))); // 0
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# Remainder with positive dividend.
print('Remainder of 12/5:', ee.Number(12).mod(ee.Number(5)).getInfo()) # 2
print('Remainder of 1/-2:', ee.Number(1).mod(ee.Number(-2)).getInfo()) # 1
print('Remainder of 1/2:', ee.Number(1).mod(ee.Number(2)).getInfo()) # 1
print('Remainder of 2/3:', ee.Number(2).mod(ee.Number(3)).getInfo()) # 2
print('Remainder of 5.5/2:', ee.Number(5.5).mod(ee.Number(2)).getInfo()) # 1.5
# Remainder with negative dividend.
print('Remainder of -12/5:', ee.Number(-12).mod(ee.Number(5)).getInfo()) # -2
print('Remainder of -1/2:', ee.Number(-1).mod(ee.Number(2)).getInfo()) # -1
print('Remainder of -4/2:', ee.Number(-4).mod(ee.Number(2)).getInfo()) # 0
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003emod()\u003c/code\u003e function calculates the remainder when one number (\u003ccode\u003eleft\u003c/code\u003e) is divided by another (\u003ccode\u003eright\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eIt accepts two arguments: \u003ccode\u003eleft\u003c/code\u003e, the dividend, and \u003ccode\u003eright\u003c/code\u003e, the divisor, both of which must be numbers.\u003c/p\u003e\n"],["\u003cp\u003eThe function returns the remainder as a number, which can be positive, negative, or zero depending on the input values.\u003c/p\u003e\n"],["\u003cp\u003eIt's available in both JavaScript and Python environments within the Earth Engine ecosystem.\u003c/p\u003e\n"],["\u003cp\u003eUsage follows the syntax \u003ccode\u003eee.Number(left).mod(ee.Number(right))\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# ee.Number.mod\n\nCalculates the remainder of the first value divided by the second.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------|---------|\n| Number.mod`(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\n// Remainder with positive dividend.\nprint('Remainder of 12/5', ee.Number(12).mod(ee.Number(5))); // 2\nprint('Remainder of 1/-2', ee.Number(1).mod(ee.Number(-2))); // 1\nprint('Remainder of 1/2', ee.Number(1).mod(ee.Number(2))); // 1\nprint('Remainder of 2/3', ee.Number(2).mod(ee.Number(3))); // 2\nprint('Remainder of 5.5/2', ee.Number(5.5).mod(ee.Number(2))); // 1.5\n\n// Remainder with negative dividend.\nprint('Remainder of -12/5', ee.Number(-12).mod(ee.Number(5))); // -2\nprint('Remainder of -1/2', ee.Number(-1).mod(ee.Number(2))); // -1\nprint('Remainder of -4/2', ee.Number(-4).mod(ee.Number(2))); // 0\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# Remainder with positive dividend.\nprint('Remainder of 12/5:', ee.Number(12).mod(ee.Number(5)).getInfo()) # 2\nprint('Remainder of 1/-2:', ee.Number(1).mod(ee.Number(-2)).getInfo()) # 1\nprint('Remainder of 1/2:', ee.Number(1).mod(ee.Number(2)).getInfo()) # 1\nprint('Remainder of 2/3:', ee.Number(2).mod(ee.Number(3)).getInfo()) # 2\nprint('Remainder of 5.5/2:', ee.Number(5.5).mod(ee.Number(2)).getInfo()) # 1.5\n\n# Remainder with negative dividend.\nprint('Remainder of -12/5:', ee.Number(-12).mod(ee.Number(5)).getInfo()) # -2\nprint('Remainder of -1/2:', ee.Number(-1).mod(ee.Number(2)).getInfo()) # -1\nprint('Remainder of -4/2:', ee.Number(-4).mod(ee.Number(2)).getInfo()) # 0\n```"]]
