ee.Date.advance

Create a new Date by adding the specified units to the given Date.

UsageReturns
Date.advance(delta, unit, timeZone)Date
ArgumentTypeDetails
this: dateDate

deltaFloat

unitString

One of 'year', 'month' 'week', 'day', 'hour', 'minute', or 'second'.

timeZoneString, default: null

The time zone (e.g. 'America/Los_Angeles'); defaults to UTC.

Examples

Code Editor (JavaScript)

// Defines a base date/time for the following examples.
var BASE_DATE = ee.Date('2020-7-1T13:00', 'UTC');
print(BASE_DATE, 'The base date/time');

// Demonstrates basic usage.
print(BASE_DATE.advance(1, 'week'), '+1 week');
print(BASE_DATE.advance(2, 'years'), '+2 years');

// Demonstrates that negative delta moves back in time.
print(BASE_DATE.advance(-1, 'second'), '-1 second');

Colab (Python)

"""Demonstrates the ee.Date.advance method."""

import ee


# Authenticates to the Earth Engine servers.
ee.Authenticate()
# Initializes the client library.
ee.Initialize()


def print_date(ee_date, message):
  """Prints a formatted date, along with a descriptive message."""
  print(ee_date.format().getInfo(), message)

# Defines a base date/time for the following examples.
BASE_DATE = ee.Date('2020-01-01T00:00', 'UTC')
print_date(BASE_DATE, 'The base date/time')

# Demonstrates basic usage.
print_date(BASE_DATE.advance(1, 'week'), '+1 week')
print_date(BASE_DATE.advance(2, 'years'), '+2 years')

# Demonstrates that negative delta moves back in time.
print_date(BASE_DATE.advance(-1, 'second'), '-1 second')