公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Date.getRelative
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
傳回此日期相對於較大單位的指定 (以 0 為基底) 單位，例如 getRelative('day', 'year') 會傳回介於 0 和 365 之間的值。
| 用量 | 傳回 |
|---|
Date.getRelative(unit, inUnit, timeZone) | 長 |
| 引數 | 類型 | 詳細資料 |
|---|
this：date | 日期 | |
unit | 字串 | 可以是「month」、「week」、「day」、「hour」、「minute」或「second」。 |
inUnit | 字串 | 可以是「year」、「month」、「week」、「day」、「hour」或「minute」。 |
timeZone | 字串，預設值：空值 | 時區 (例如'America/Los_Angeles')；預設為世界標準時間。 |
範例
程式碼編輯器 (JavaScript)
var date = ee.Date('2021-4-30T07:15:31.24');
print('0-based month of year', date.getRelative('month', 'year'));
print('0-based week of year', date.getRelative('week', 'year'));
print('0-based day of year', date.getRelative('day', 'year'));
print('0-based day of month', date.getRelative('day', 'month'));
print('0-based minute of day', date.getRelative('minute', 'day'));
print('0-based second of minute', date.getRelative('second', 'minute'));
// 0 is returned when unit argument is larger than inUnit argument.
print('0-based year of month (bad form)', date.getRelative('year', 'month'));
Python 設定
請參閱「
Python 環境」頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
date = ee.Date('2021-4-30T07:15:31.24')
display('0-based month of year:', date.getRelative('month', 'year'))
display('0-based week of year:', date.getRelative('week', 'year'))
display('0-based day of year:', date.getRelative('day', 'year'))
display('0-based day of month:', date.getRelative('day', 'month'))
display('0-based minute of day:', date.getRelative('minute', 'day'))
display('0-based second of minute:', date.getRelative('second', 'minute'))
# 0 is returned when unit argument is larger than inUnit argument.
display('0-based year of month (bad form):', date.getRelative('year', 'month'))
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eDate.getRelative()\u003c/code\u003e returns the 0-based position of a specified time unit (e.g., day, month) within a larger time unit (e.g., year, month).\u003c/p\u003e\n"],["\u003cp\u003eThe function takes 'unit', 'inUnit', and an optional 'timeZone' as arguments to define the relative position and time zone context.\u003c/p\u003e\n"],["\u003cp\u003eValid units include 'year', 'month', 'week', 'day', 'hour', 'minute', and 'second'.\u003c/p\u003e\n"],["\u003cp\u003eIf the 'unit' is larger than the 'inUnit', the function returns 0.\u003c/p\u003e\n"]]],[],null,["# ee.Date.getRelative\n\nReturns the specified (0-based) unit of this date relative to a larger unit, e.g., getRelative('day', 'year') returns a value between 0 and 365.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------|---------|\n| Date.getRelative`(unit, inUnit, `*timeZone*`)` | Long |\n\n| Argument | Type | Details |\n|--------------|-----------------------|---------------------------------------------------------------|\n| this: `date` | Date | |\n| `unit` | String | One of 'month', 'week', 'day', 'hour', 'minute', or 'second'. |\n| `inUnit` | String | One of 'year', 'month', 'week', 'day', 'hour', or 'minute'. |\n| `timeZone` | String, default: null | The time zone (e.g., 'America/Los_Angeles'); defaults to UTC. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar date = ee.Date('2021-4-30T07:15:31.24');\n\nprint('0-based month of year', date.getRelative('month', 'year'));\nprint('0-based week of year', date.getRelative('week', 'year'));\nprint('0-based day of year', date.getRelative('day', 'year'));\nprint('0-based day of month', date.getRelative('day', 'month'));\nprint('0-based minute of day', date.getRelative('minute', 'day'));\nprint('0-based second of minute', date.getRelative('second', 'minute'));\n\n// 0 is returned when unit argument is larger than inUnit argument.\nprint('0-based year of month (bad form)', date.getRelative('year', 'month'));\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\ndate = ee.Date('2021-4-30T07:15:31.24')\n\ndisplay('0-based month of year:', date.getRelative('month', 'year'))\ndisplay('0-based week of year:', date.getRelative('week', 'year'))\ndisplay('0-based day of year:', date.getRelative('day', 'year'))\ndisplay('0-based day of month:', date.getRelative('day', 'month'))\ndisplay('0-based minute of day:', date.getRelative('minute', 'day'))\ndisplay('0-based second of minute:', date.getRelative('second', 'minute'))\n\n# 0 is returned when unit argument is larger than inUnit argument.\ndisplay('0-based year of month (bad form):', date.getRelative('year', 'month'))\n```"]]
