Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Date.parse
Stay organized with collections
Save and categorize content based on your preferences.
Parse a date string, given a string describing its format.
| Usage | Returns | ee.Date.parse(format, date, timeZone) | Date |
| Argument | Type | Details | format | String | A pattern, as described at http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. |
date | String | A string matching the given pattern. |
timeZone | String, default: null | The time zone (e.g., 'America/Los_Angeles'); defaults to UTC. |
Examples
Code Editor (JavaScript)
print(ee.Date.parse('yyyy MM dd', '2021 4 30'));
print(ee.Date.parse('yyyy-MM-dd', '2021-4-30'));
print(ee.Date.parse('yyyy/MM/dd', '2021/4/30'));
print(ee.Date.parse('MM/dd/yy', '4/30/21'));
print(ee.Date.parse('MMM. dd, yyyy', 'Apr. 30, 2021'));
print(ee.Date.parse('yyyy-MM-dd HH:mm:ss', '2021-4-30 00:00:00'));
Python setup
See the
Python Environment page for information on the Python API and using
geemap for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
display(ee.Date.parse('YYYY MM dd', '2021 4 30'))
display(ee.Date.parse('YYYY-MM-dd', '2021-4-30'))
display(ee.Date.parse('YYYY/MM/dd', '2021/4/30'))
display(ee.Date.parse('MM/dd/YY', '4/30/21'))
display(ee.Date.parse('MMM. dd, YYYY', 'Apr. 30, 2021'))
display(ee.Date.parse('YYYY-MM-dd HH:mm:ss', '2021-4-30 00:00:00'))
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-13 UTC.
[null,null,["Last updated 2024-07-13 UTC."],[[["\u003cp\u003e\u003ccode\u003eee.Date.parse()\u003c/code\u003e allows you to convert a date string into a Date object by specifying the string's format.\u003c/p\u003e\n"],["\u003cp\u003eIt accepts a format pattern based on Joda-Time's DateTimeFormat, the date string itself, and an optional time zone (defaulting to UTC).\u003c/p\u003e\n"],["\u003cp\u003eVarious format patterns can be used, such as 'YYYY MM dd', 'YYYY-MM-dd', 'YYYY/MM/dd', 'MM/dd/YY', 'MMM.dd, YYYY', and 'YYYY-MM-dd HH:mm:ss'.\u003c/p\u003e\n"]]],["The `ee.Date.parse` function converts a date string into a Date object. It requires a `format` string, following Joda-Time patterns, to define the structure of the input `date` string. An optional `timeZone` can be specified, defaulting to UTC. Valid examples are provided and demostrated for various formats like 'yyyy MM dd', 'yyyy-MM-dd' or 'MM/dd/yy'. The function will return a new date based on the parsing of the date string.\n"],null,["# ee.Date.parse\n\nParse a date string, given a string describing its format.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------|---------|\n| `ee.Date.parse(format, date, `*timeZone*`)` | Date |\n\n| Argument | Type | Details |\n|------------|-----------------------|---------------------------------------------------------------------------------------------------------------|\n| `format` | String | A pattern, as described at http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. |\n| `date` | String | A string matching the given pattern. |\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\nprint(ee.Date.parse('yyyy MM dd', '2021 4 30'));\nprint(ee.Date.parse('yyyy-MM-dd', '2021-4-30'));\nprint(ee.Date.parse('yyyy/MM/dd', '2021/4/30'));\nprint(ee.Date.parse('MM/dd/yy', '4/30/21'));\nprint(ee.Date.parse('MMM. dd, yyyy', 'Apr. 30, 2021'));\nprint(ee.Date.parse('yyyy-MM-dd HH:mm:ss', '2021-4-30 00:00:00'));\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\ndisplay(ee.Date.parse('YYYY MM dd', '2021 4 30'))\ndisplay(ee.Date.parse('YYYY-MM-dd', '2021-4-30'))\ndisplay(ee.Date.parse('YYYY/MM/dd', '2021/4/30'))\ndisplay(ee.Date.parse('MM/dd/YY', '4/30/21'))\ndisplay(ee.Date.parse('MMM. dd, YYYY', 'Apr. 30, 2021'))\ndisplay(ee.Date.parse('YYYY-MM-dd HH:mm:ss', '2021-4-30 00:00:00'))\n```"]]