公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.Date.getInfo
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
从服务器检索此对象的值。
如果未提供回调函数,则以同步方式发出请求。如果提供了回调,则会异步发出请求。
建议使用异步模式,因为同步模式在等待服务器时会停止所有其他代码(例如 EE 代码编辑器界面)。如需发出异步请求,建议使用 evaluate() 而不是 getInfo()。
返回此对象的计算值。
用法 | 返回 |
---|
Date.getInfo(callback) | 对象 |
参数 | 类型 | 详细信息 |
---|
此:computedobject | ComputedObject | ComputedObject 实例。 |
callback | 函数(可选) | 可选的回调。如果未提供,则以同步方式进行调用。 |
示例
代码编辑器 (JavaScript)
/**
* WARNING: this function transfers data from Earth Engine servers to the
* client. Doing so can negatively affect request processing and client
* performance. Server-side options should be used whenever possible.
* Learn more about the distinction between server and client:
* https://developers.google.com/earth-engine/guides/client_server
*/
// A server-side ee.Date object.
var dateServer = ee.Date('2021-4-30');
// Use getInfo to transfer server-side date to the client. The result is
// an object with keys "type" and "value" where "value" is milliseconds since
// Unix epoch.
var dateClient = dateServer.getInfo();
print('Client-side date is an object', typeof dateClient);
print('Object keys include "type" and "value"', Object.keys(dateClient));
print('"value" is milliseconds since Unix epoch', dateClient.value);
print('Client-side date in JS Date constructor', new Date(dateClient.value));
Python 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
"""
WARNING: this function transfers data from Earth Engine servers to the
client. Doing so can negatively affect request processing and client
performance. Server-side options should be used whenever possible.
Learn more about the distinction between server and client:
https://developers.google.com/earth-engine/guides/client_server
"""
from datetime import datetime
# A server-side ee.Date object.
date_server = ee.Date('2021-4-30')
# Use getInfo to transfer server-side date to the client. The result is
# a dictionary with keys "type" and "value" where "value" is milliseconds since
# Unix epoch.
date_client = date_server.getInfo()
print('Client-side date is a dictionary:', type(date_client))
print('Dictionary keys include "type" and "value":', date_client.keys())
print('"value" is milliseconds since Unix epoch:', date_client['value'])
print('Client-side date in Python:',
datetime.fromtimestamp(date_client['value'] / 1000))
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003egetInfo()\u003c/code\u003e retrieves the value of a server-side ComputedObject (like ee.Date) and transfers it to the client.\u003c/p\u003e\n"],["\u003cp\u003eIt returns an object containing the computed value, with synchronous or asynchronous behavior depending on the presence of a callback function.\u003c/p\u003e\n"],["\u003cp\u003eAsynchronous requests, typically made with \u003ccode\u003eevaluate()\u003c/code\u003e, are preferred to avoid blocking other code execution.\u003c/p\u003e\n"],["\u003cp\u003eThe returned object, when dealing with dates, contains \u003ccode\u003etype\u003c/code\u003e and \u003ccode\u003evalue\u003c/code\u003e keys, where \u003ccode\u003evalue\u003c/code\u003e represents milliseconds since the Unix epoch.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003egetInfo()\u003c/code\u003e facilitates client-side data interaction, server-side operations are generally recommended for better performance and efficiency.\u003c/p\u003e\n"]]],["`getInfo()` retrieves a ComputedObject's value from the server. It can operate synchronously (no callback) or asynchronously (with a callback), the latter being preferred. It returns the object's computed value. For example a Date.getInfo() call will return an object with 'type' and 'value' keys. The value is in miliseconds since the Unix epoch. The function should be used carefully, as it transfers data from Earth Engine servers to the client.\n"],null,["# ee.Date.getInfo\n\n\u003cbr /\u003e\n\nRetrieves the value of this object from the server.\n\n\u003cbr /\u003e\n\nIf no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.\n\nThe asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().\n\nReturns the computed value of this object.\n\n| Usage | Returns |\n|------------------------------|---------|\n| Date.getInfo`(`*callback*`)` | Object |\n\n| Argument | Type | Details |\n|------------------------|--------------------|------------------------------------------------------------------------|\n| this: `computedobject` | ComputedObject | The ComputedObject instance. |\n| `callback` | Function, optional | An optional callback. If not supplied, the call is made synchronously. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n/**\n * WARNING: this function transfers data from Earth Engine servers to the\n * client. Doing so can negatively affect request processing and client\n * performance. Server-side options should be used whenever possible.\n * Learn more about the distinction between server and client:\n * https://developers.google.com/earth-engine/guides/client_server\n */\n\n// A server-side ee.Date object.\nvar dateServer = ee.Date('2021-4-30');\n\n// Use getInfo to transfer server-side date to the client. The result is\n// an object with keys \"type\" and \"value\" where \"value\" is milliseconds since\n// Unix epoch.\nvar dateClient = dateServer.getInfo();\nprint('Client-side date is an object', typeof dateClient);\nprint('Object keys include \"type\" and \"value\"', Object.keys(dateClient));\nprint('\"value\" is milliseconds since Unix epoch', dateClient.value);\nprint('Client-side date in JS Date constructor', new Date(dateClient.value));\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\n\"\"\"\nWARNING: this function transfers data from Earth Engine servers to the\nclient. Doing so can negatively affect request processing and client\nperformance. Server-side options should be used whenever possible.\nLearn more about the distinction between server and client:\nhttps://developers.google.com/earth-engine/guides/client_server\n\"\"\"\nfrom datetime import datetime\n\n# A server-side ee.Date object.\ndate_server = ee.Date('2021-4-30')\n\n# Use getInfo to transfer server-side date to the client. The result is\n# a dictionary with keys \"type\" and \"value\" where \"value\" is milliseconds since\n# Unix epoch.\ndate_client = date_server.getInfo()\nprint('Client-side date is a dictionary:', type(date_client))\nprint('Dictionary keys include \"type\" and \"value\":', date_client.keys())\nprint('\"value\" is milliseconds since Unix epoch:', date_client['value'])\nprint('Client-side date in Python:',\n datetime.fromtimestamp(date_client['value'] / 1000))\n```"]]