ee.Date.getRelative
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
واحد مشخص شده (بر اساس 0) این تاریخ را نسبت به یک واحد بزرگتر برمی گرداند، به عنوان مثال، getRelative('day', 'year') مقداری بین 0 و 365 برمی گرداند.
| استفاده | برمی گرداند | Date. getRelative (unit, inUnit, timeZone ) | طولانی |
| استدلال | تایپ کنید | جزئیات | این: date | تاریخ | |
unit | رشته | یکی از «ماه»، «هفته»، «روز»، «ساعت»، «دقیقه» یا «دوم». |
inUnit | رشته | یکی از «سال»، «ماه»، «هفته»، «روز»، «ساعت» یا «دقیقه». |
timeZone | رشته، پیش فرض: null | منطقه زمانی (به عنوان مثال، "America/Los_Angeles")؛ پیش فرض UTC است. |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
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')); راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
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'))
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]
