Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Date
Stay organized with collections
Save and categorize content based on your preferences.
Constructs a new Date object.
| Usage | Returns | ee.Date(date, tz) | Date |
| Argument | Type | Details | date | ComputedObject|Date|Number|String | The date to convert, one of: a number (number of milliseconds since the epoch), an ISO Date string, a JavaScript Date or a ComputedObject. |
tz | String, optional | An optional timezone only to be used with a string date. |
Examples
Code Editor (JavaScript)
// Numeric inputs are interpreted as milliseconds from Unix epoch.
print(ee.Date(0)); // Date (1970-01-01 00:00:00)
// Scale factors can make numerical inputs more readable (e.g. 60 seconds).
print(ee.Date(60 * 1000)); // Date (1970-01-01 00:01:00)
// ISO 8601 date string input examples.
print(ee.Date('2020')); // Date (2020-01-01 00:00:00)
print(ee.Date('2017-6-24')); // Date (2017-06-24 00:00:00)
print(ee.Date('2017-06-24')); // Date (2017-06-24 00:00:00)
print(ee.Date('2017-6-24T00:14:46')); // Date (2017-06-24 00:14:46)
print(ee.Date('2017-06-24T23:59:59')); // Date (2017-06-24 23:59:59)
// With an optional time zone.
print(ee.Date('2020', 'US/Mountain')); // Date (2020-01-01T07:00:00)
// Convert JavaScript now to Earth Engine Date
print(ee.Date(Date.now()));
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)
from datetime import datetime
# Numeric inputs are interpreted as milliseconds from Unix epoch.
print(ee.Date(0).format().getInfo()) # 1970-01-01T00:00:00
# Scale factors can make numerical inputs more readable (e.g. 60 seconds).
print(ee.Date(60 * 1000).format().getInfo()) # 1970-01-01T00:01:00
# ISO 8601 date string input examples.
print(ee.Date('2020').format().getInfo()) # 2020-01-01T00:00:00
print(ee.Date('2017-6-24').format().getInfo()) # 2017-06-24T00:00:00
print(ee.Date('2017-06-24').format().getInfo()) # 2017-06-24T00:00:00
print(ee.Date('2017-6-24T00:14:46').format().getInfo()) # 2017-06-24T00:14:46
print(ee.Date('2017-06-24T23:59:59').format().getInfo()) # 2017-06-24T23:59:59
# With an optional time zone.
print(ee.Date('2020', 'US/Mountain').format().getInfo()) # 2020-01-01T07:00:00
# Convert Python datetime.now() to Earth Engine Date
print(ee.Date(datetime.now()).format().getInfo())
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 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eee.Date()\u003c/code\u003e constructor creates a new Date object in Earth Engine.\u003c/p\u003e\n"],["\u003cp\u003eIt accepts various input types for the date: a number (milliseconds since epoch), an ISO Date string, a JavaScript Date, or a ComputedObject.\u003c/p\u003e\n"],["\u003cp\u003eAn optional timezone argument (\u003ccode\u003etz\u003c/code\u003e) can be provided when using a string date input.\u003c/p\u003e\n"],["\u003cp\u003eNumerical inputs can be scaled for readability, like using 60 * 1000 to represent 60 seconds.\u003c/p\u003e\n"],["\u003cp\u003eExamples demonstrate creating dates from different inputs and formatting them using \u003ccode\u003eformat().getInfo()\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `ee.Date` function creates a new Date object, accepting various inputs: milliseconds since the epoch, ISO date strings, JavaScript Dates, or ComputedObjects. It can use numeric inputs, interpreted as milliseconds, or date strings following ISO 8601 format. An optional timezone argument (string) can be provided with string date input to specify the timezone. The function returns a Date object and examples in JavaScript and Python are provided.\n"],null,["# ee.Date\n\n\u003cbr /\u003e\n\nConstructs a new Date object.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------------|---------|\n| `ee.Date(date, `*tz*`)` | Date |\n\n| Argument | Type | Details |\n|----------|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | ComputedObject\\|Date\\|Number\\|String | The date to convert, one of: a number (number of milliseconds since the epoch), an ISO Date string, a JavaScript Date or a ComputedObject. |\n| `tz` | String, optional | An optional timezone only to be used with a string date. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Numeric inputs are interpreted as milliseconds from Unix epoch.\nprint(ee.Date(0)); // Date (1970-01-01 00:00:00)\n\n// Scale factors can make numerical inputs more readable (e.g. 60 seconds).\nprint(ee.Date(60 * 1000)); // Date (1970-01-01 00:01:00)\n\n// ISO 8601 date string input examples.\nprint(ee.Date('2020')); // Date (2020-01-01 00:00:00)\nprint(ee.Date('2017-6-24')); // Date (2017-06-24 00:00:00)\nprint(ee.Date('2017-06-24')); // Date (2017-06-24 00:00:00)\nprint(ee.Date('2017-6-24T00:14:46')); // Date (2017-06-24 00:14:46)\nprint(ee.Date('2017-06-24T23:59:59')); // Date (2017-06-24 23:59:59)\n\n// With an optional time zone.\nprint(ee.Date('2020', 'US/Mountain')); // Date (2020-01-01T07:00:00)\n\n// Convert JavaScript now to Earth Engine Date\nprint(ee.Date(Date.now()));\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\nfrom datetime import datetime\n\n# Numeric inputs are interpreted as milliseconds from Unix epoch.\nprint(ee.Date(0).format().getInfo()) # 1970-01-01T00:00:00\n\n# Scale factors can make numerical inputs more readable (e.g. 60 seconds).\nprint(ee.Date(60 * 1000).format().getInfo()) # 1970-01-01T00:01:00\n\n# ISO 8601 date string input examples.\nprint(ee.Date('2020').format().getInfo()) # 2020-01-01T00:00:00\nprint(ee.Date('2017-6-24').format().getInfo()) # 2017-06-24T00:00:00\nprint(ee.Date('2017-06-24').format().getInfo()) # 2017-06-24T00:00:00\nprint(ee.Date('2017-6-24T00:14:46').format().getInfo()) # 2017-06-24T00:14:46\nprint(ee.Date('2017-06-24T23:59:59').format().getInfo()) # 2017-06-24T23:59:59\n\n# With an optional time zone.\nprint(ee.Date('2020', 'US/Mountain').format().getInfo()) # 2020-01-01T07:00:00\n\n# Convert Python datetime.now() to Earth Engine Date\nprint(ee.Date(datetime.now()).format().getInfo())\n```"]]