Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Date.aside
Stay organized with collections
Save and categorize content based on your preferences.
Calls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:
var c = ee.ImageCollection('foo').aside(print)
.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')
.filterBounds(geom).aside(print, 'In region')
.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')
.select('a', 'b');
Returns the same object, for chaining.
Usage | Returns | Date.aside(func, var_args) | ComputedObject |
Argument | Type | Details | this: computedobject | ComputedObject | The ComputedObject instance. |
func | Function | The function to call. |
var_args | VarArgs<Object> | Any extra arguments to pass to the function. |
Examples
Code Editor (JavaScript)
// Print a message when constructing the ee.Date.
var eeDict = ee.Date(Date.now()).aside(print, "Today's date (UTC)");
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
def print_date(ee_date, message):
"""Prints a formatted date, along with a descriptive message."""
display(message, ee_date.format("YYYY-mm-dd"))
# Print a message when constructing the ee.Date.
ee_date = ee.Date(datetime.now()).aside(print_date, "Today's date (UTC):")
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 2025-07-08 UTC.
[null,null,["Last updated 2025-07-08 UTC."],[[["\u003cp\u003e\u003ccode\u003easide()\u003c/code\u003e allows you to call a function on a ComputedObject (like an ImageCollection or Date) for debugging or visualization without interrupting the chain of operations.\u003c/p\u003e\n"],["\u003cp\u003eIt passes the ComputedObject as the first argument to the provided function, along with any additional arguments you specify.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003easide()\u003c/code\u003e returns the original ComputedObject, making it seamless to integrate into existing workflows.\u003c/p\u003e\n"],["\u003cp\u003eThe function you provide to \u003ccode\u003easide()\u003c/code\u003e can be anything, from \u003ccode\u003eprint()\u003c/code\u003e for debugging to \u003ccode\u003eMap.addLayer()\u003c/code\u003e for visualization.\u003c/p\u003e\n"],["\u003cp\u003eThis method facilitates understanding intermediate steps and inspecting results within a sequence of Earth Engine operations.\u003c/p\u003e\n"]]],["The `aside` function, applicable to `ComputedObject` instances, executes a provided function (`func`) with the object as the first argument, alongside any additional arguments (`var_args`). It returns the original object, enabling method chaining. This is useful for debugging or applying side effects, such as printing values or adding layers to a map during data processing. Examples show its use with `ee.Date` and `ee.ImageCollection` in both JavaScript and Python environments.\n"],null,["# ee.Date.aside\n\n\u003cbr /\u003e\n\nCalls a function passing this object as the first argument, and returning itself. Convenient e.g. when debugging:\n\n\u003cbr /\u003e\n\nvar c = ee.ImageCollection('foo').aside(print)\n\n.filterDate('2001-01-01', '2002-01-01').aside(print, 'In 2001')\n\n.filterBounds(geom).aside(print, 'In region')\n\n.aside(Map.addLayer, {min: 0, max: 142}, 'Filtered')\n\n.select('a', 'b');\n\nReturns the same object, for chaining.\n\n| Usage | Returns |\n|------------------------------|----------------|\n| Date.aside`(func, var_args)` | ComputedObject |\n\n| Argument | Type | Details |\n|------------------------|-------------------|----------------------------------------------|\n| this: `computedobject` | ComputedObject | The ComputedObject instance. |\n| `func` | Function | The function to call. |\n| `var_args` | VarArgs\\\u003cObject\\\u003e | Any extra arguments to pass to the function. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Print a message when constructing the ee.Date.\nvar eeDict = ee.Date(Date.now()).aside(print, \"Today's date (UTC)\");\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\ndef print_date(ee_date, message):\n \"\"\"Prints a formatted date, along with a descriptive message.\"\"\"\n display(message, ee_date.format(\"YYYY-mm-dd\"))\n\n# Print a message when constructing the ee.Date.\nee_date = ee.Date(datetime.now()).aside(print_date, \"Today's date (UTC):\")\n```"]]