ee.Date.getRange
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie une DateRange couvrant l'unité du type spécifié qui contient cette date, par exemple : Date('2013-3-15').getRange('year') renvoie DateRange('2013-1-1', '2014-1-1').
Utilisation | Renvoie |
---|
Date.getRange(unit, timeZone) | DateRange |
Argument | Type | Détails |
---|
ce: date | Date | |
unit | Chaîne | "année", "mois", "semaine", "jour", "heure", "minute" ou "seconde". |
timeZone | Chaîne, valeur par défaut: null | Fuseau horaire (par exemple, 'America/Los_Angeles') ; la valeur par défaut est UTC. |
Exemples
Éditeur de code (JavaScript)
var date = ee.Date('2021-4-30T07:15:31.24');
print('1-year date range covering input date', date.getRange('year'));
print('1-month date range covering input date', date.getRange('month'));
print('1-week date range covering input date', date.getRange('week'));
print('1-day date range covering input date', date.getRange('day'));
print('1-hour date range covering input date', date.getRange('hour'));
print('1-minute date range covering input date', date.getRange('minute'));
print('1-second date range covering input date', date.getRange('second'));
Configuration de Python
Consultez la page
Environnement Python pour en savoir plus sur l'API Python et l'utilisation de geemap
pour le développement interactif.
import ee
import geemap.core as geemap
Colab (Python)
date = ee.Date('2021-4-30T07:15:31.24')
display('1-year date range covering input date:', date.getRange('year'))
display('1-month date range covering input date:', date.getRange('month'))
display('1-week date range covering input date:', date.getRange('week'))
display('1-day date range covering input date:', date.getRange('day'))
display('1-hour date range covering input date:', date.getRange('hour'))
display('1-minute date range covering input date:', date.getRange('minute'))
display('1-second date range covering input date:', date.getRange('second'))
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eDate.getRange()\u003c/code\u003e returns a \u003ccode\u003eDateRange\u003c/code\u003e object representing the specified time unit (year, month, week, day, hour, minute, or second) that contains the input date.\u003c/p\u003e\n"],["\u003cp\u003eThe returned \u003ccode\u003eDateRange\u003c/code\u003e spans the entire unit of time, for example, if the input date is March 15, 2013, and the unit is 'year', the returned \u003ccode\u003eDateRange\u003c/code\u003e will be from January 1, 2013, to January 1, 2014.\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally specify a time zone for the \u003ccode\u003eDateRange\u003c/code\u003e; if not provided, it defaults to UTC.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for creating time-based filters or selecting data within specific time intervals.\u003c/p\u003e\n"]]],[],null,["# ee.Date.getRange\n\nReturns a DateRange covering the unit of the specified type that contains this date, e.g., Date('2013-3-15').getRange('year') returns DateRange('2013-1-1', '2014-1-1').\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------------------------|-----------|\n| Date.getRange`(unit, `*timeZone*`)` | DateRange |\n\n| Argument | Type | Details |\n|--------------|-----------------------|-----------------------------------------------------------------------|\n| this: `date` | Date | |\n| `unit` | String | One of 'year', 'month', 'week', 'day', 'hour', 'minute', or 'second'. |\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('1-year date range covering input date', date.getRange('year'));\nprint('1-month date range covering input date', date.getRange('month'));\nprint('1-week date range covering input date', date.getRange('week'));\nprint('1-day date range covering input date', date.getRange('day'));\nprint('1-hour date range covering input date', date.getRange('hour'));\nprint('1-minute date range covering input date', date.getRange('minute'));\nprint('1-second date range covering input date', date.getRange('second'));\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('1-year date range covering input date:', date.getRange('year'))\ndisplay('1-month date range covering input date:', date.getRange('month'))\ndisplay('1-week date range covering input date:', date.getRange('week'))\ndisplay('1-day date range covering input date:', date.getRange('day'))\ndisplay('1-hour date range covering input date:', date.getRange('hour'))\ndisplay('1-minute date range covering input date:', date.getRange('minute'))\ndisplay('1-second date range covering input date:', date.getRange('second'))\n```"]]