ee.Date.update

  • The Date.update() function modifies specific components (year, month, day, hour, minute, second) of an existing Earth Engine Date object.

  • The function accepts optional arguments for each date/time component, using the provided values to update the original date.

  • If a timeZone is specified, the new date/time components are interpreted within that time zone, otherwise defaulting to UTC.

  • Date.update() returns a new Date object with the modifications, leaving the original date unchanged.

 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.

UsageReturns
Date.update(year, month, day, hour, minute, second, timeZone)Date
ArgumentTypeDetails
this: dateDate
yearInteger, default: null
monthInteger, default: null
dayInteger, default: null
hourInteger, default: null
minuteInteger, default: null
secondNumber, default: null
timeZoneString, default: nullThe time zone (e.g., 'America/Los_Angeles'); defaults to UTC.

Examples

Code Editor (JavaScript)

var date = ee.Date('2021-4-30T07:15:31.24');

print('Updated year and minute components of the input date',
  date.update({
    year: 2010,
    minute: 59
  })
);

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)

date = ee.Date('2021-4-30T07:15:31.24')

display(
    'Updated year and minute components of the input date:',
    date.update(year=2010, minute=59)
)