Stay organized with collectionsSave and categorize content based on your preferences.
Create a new Date by setting one or more of the units of the given Date to a new value. If a timeZone is given the new value(s) is interpreted in that zone.
[[["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 2024-07-13 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eDate.update()\u003c/code\u003e function modifies specific components (year, month, day, hour, minute, second) of an existing Earth Engine \u003ccode\u003eDate\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eThe function accepts optional arguments for each date/time component, using the provided values to update the original date.\u003c/p\u003e\n"],["\u003cp\u003eIf a \u003ccode\u003etimeZone\u003c/code\u003e is specified, the new date/time components are interpreted within that time zone, otherwise defaulting to UTC.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDate.update()\u003c/code\u003e returns a new \u003ccode\u003eDate\u003c/code\u003e object with the modifications, leaving the original date unchanged.\u003c/p\u003e\n"]]],[],null,["# ee.Date.update\n\nCreate a new Date by setting one or more of the units of the given Date to a new value. If a timeZone is given the new value(s) is interpreted in that zone.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------------------------------------------------------------|---------|\n| Date.update`(`*year* `, `*month* `, `*day* `, `*hour* `, `*minute* `, `*second* `, `*timeZone*`)` | Date |\n\n| Argument | Type | Details |\n|--------------|------------------------|---------------------------------------------------------------|\n| this: `date` | Date | |\n| `year` | Integer, default: null | |\n| `month` | Integer, default: null | |\n| `day` | Integer, default: null | |\n| `hour` | Integer, default: null | |\n| `minute` | Integer, default: null | |\n| `second` | Number, default: null | |\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('Updated year and minute components of the input date',\n date.update({\n year: 2010,\n minute: 59\n })\n);\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(\n 'Updated year and minute components of the input date:',\n date.update(year=2010, minute=59)\n)\n```"]]