Объявление : Все некоммерческие проекты, зарегистрированные для использования Earth Engine до
15 апреля 2025 года, должны
подтвердить некоммерческое право на сохранение доступа к Earth Engine.
ee.Date.getRelative
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Возвращает указанную (начиная с 0) единицу этой даты относительно большей единицы, например, getRelative('day', 'year') возвращает значение от 0 до 365.
| Использование | Возвраты | Date. getRelative (unit, inUnit, timeZone ) | Длинный |
| Аргумент | Тип | Подробности | это: date | Дата | |
unit | Нить | Один из вариантов: «месяц», «неделя», «день», «час», «минута» или «секунда». |
inUnit | Нить | Один из вариантов: «год», «месяц», «неделя», «день», «час» или «минута». |
timeZone | Строка, по умолчанию: null | Часовой пояс (например, «Америка/Лос-Анджелес»); по умолчанию — UTC. |
Примеры
Редактор кода (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
Информацию об API Python и использовании geemap для интерактивной разработки см. на странице Python Environment .
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'))
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\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```"]]
