ee.Date.advance
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellen Sie ein neues Datum, indem Sie dem angegebenen Datum die angegebenen Einheiten hinzufügen.
Nutzung | Ausgabe |
---|
Date.advance(delta, unit, timeZone) | Datum |
Argument | Typ | Details |
---|
das: date | Datum | |
delta | Gleitkommazahl | |
unit | String | Entweder „Jahr“, „Monat“, „Woche“, „Tag“, „Stunde“, „Minute“ oder „Sekunde“. |
timeZone | String, Standard: „null“ | Die Zeitzone (z.B. 'America/Los_Angeles'); standardmäßig UTC. |
Beispiele
Code-Editor (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');
Python einrichten
Auf der Seite
Python-Umgebung finden Sie Informationen zur Python API und zur Verwendung von geemap
für die interaktive Entwicklung.
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'))
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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```"]]