Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-23 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```"]]