ee.Date.advance
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Créez une date en ajoutant les unités spécifiées à la date donnée.
| Utilisation | Renvoie |
|---|
Date.advance(delta, unit, timeZone) | Date |
| Argument | Type | Détails |
|---|
ce: date | Date | |
delta | Float | |
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)
// Defines a base date/time for the following examples.
var BASE_DATE = ee.Date('2020-7-1T13:00', 'UTC');
print(BASE_DATE, 'The base date/time');
// Demonstrates basic usage.
print(BASE_DATE.advance(1, 'week'), '+1 week');
print(BASE_DATE.advance(2, 'years'), '+2 years');
// Demonstrates that negative delta moves back in time.
print(BASE_DATE.advance(-1, 'second'), '-1 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)
# Defines a base date/time for the following examples.
BASE_DATE = ee.Date('2020-01-01T00:00', 'UTC')
display('The base date/time', BASE_DATE)
# Demonstrates basic usage.
display('+1 week', BASE_DATE.advance(1, 'week'))
display('+2 years', BASE_DATE.advance(2, 'years'))
# Demonstrates that negative delta moves back in time.
display('-1 second', BASE_DATE.advance(-1, '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.advance()\u003c/code\u003e creates a new Date object by adding a specified amount of time to an existing Date.\u003c/p\u003e\n"],["\u003cp\u003eThe time units for advancement can be 'year', 'month', 'week', 'day', 'hour', 'minute', or 'second'.\u003c/p\u003e\n"],["\u003cp\u003eA positive \u003ccode\u003edelta\u003c/code\u003e argument moves the date forward in time, while a negative \u003ccode\u003edelta\u003c/code\u003e moves it backward.\u003c/p\u003e\n"],["\u003cp\u003eThe optional \u003ccode\u003etimeZone\u003c/code\u003e argument specifies the time zone for the calculation; it defaults to UTC if not provided.\u003c/p\u003e\n"]]],["The `Date.advance` function modifies a given date by adding a specified `delta` of time units. Units can be 'year', 'month', 'week', 'day', 'hour', 'minute', or 'second'. A negative `delta` subtracts time. An optional `timeZone` argument sets the time zone. It takes a date object, a float for `delta` and string for `unit` as arguments. The function returns a new Date object with modified time.\n"],null,["# ee.Date.advance\n\nCreate a new Date by adding the specified units to the given Date.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------------------------------|---------|\n| Date.advance`(delta, unit, `*timeZone*`)` | Date |\n\n| Argument | Type | Details |\n|--------------|-----------------------|-----------------------------------------------------------------------|\n| this: `date` | Date | |\n| `delta` | Float | |\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\n// Defines a base date/time for the following examples.\nvar BASE_DATE = ee.Date('2020-7-1T13:00', 'UTC');\nprint(BASE_DATE, 'The base date/time');\n\n// Demonstrates basic usage.\nprint(BASE_DATE.advance(1, 'week'), '+1 week');\nprint(BASE_DATE.advance(2, 'years'), '+2 years');\n\n// Demonstrates that negative delta moves back in time.\nprint(BASE_DATE.advance(-1, 'second'), '-1 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\n# Defines a base date/time for the following examples.\nBASE_DATE = ee.Date('2020-01-01T00:00', 'UTC')\ndisplay('The base date/time', BASE_DATE)\n\n# Demonstrates basic usage.\ndisplay('+1 week', BASE_DATE.advance(1, 'week'))\ndisplay('+2 years', BASE_DATE.advance(2, 'years'))\n\n# Demonstrates that negative delta moves back in time.\ndisplay('-1 second', BASE_DATE.advance(-1, 'second'))\n```"]]
