公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.Date.format
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将日期转换为字符串。
用法 | 返回 |
---|
Date.format(format, timeZone) | 字符串 |
参数 | 类型 | 详细信息 |
---|
此:date | 日期 | |
format | 字符串,默认值:null | 一种模式,如 http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html 中所述;如果省略,将使用 ISO 标准日期格式。 |
timeZone | 字符串,默认值:null | 时区(例如,“America/Los_Angeles”);默认为 UTC。 |
示例
代码编辑器 (JavaScript)
// Various examples of ee.Date.format with Joda-Time formatting and time zones.
var date = ee.Date('2020-08-18'); // Defaults to UTC
print(date); // Date (2020-08-18 00:00:00)
// List of time zones:
// https://www.joda.org/joda-time/timezones.html
print(date.format(null, 'GMT')); // 2020-08-18T00:00:00
print(date.format(null, 'Etc/GMT')); // 2020-08-18T00:00:00
print(date.format(null, 'Etc/GMT+0')); // 2020-08-18T00:00:00
print(date.format(null, 'Zulu')); // 2020-08-18T00:00:00
print(date.format(null, 'UTC')); // 2020-08-18T00:00:00
print(date.format(null, 'America/Los_Angeles')); // 2020-08-17T17:00:00
print(date.format(null, 'US/Pacific')); // 2020-08-17T17:00:00
print(date.format(null, 'Etc/GMT+8')); // 2020-08-17T17:00:00
print(date.format(null, 'PST8PDT')); // 2020-08-17T17:00:00
print(date.format(null, 'Australia/Tasmania')); // 2020-08-18T10:00:00
print(date.format(null, 'Etc/GMT-10')); // 2020-08-18T10:00:00
// Reference for Joda-Time format characters:
// https://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html
var datetime = ee.Date('1975-07-23T21:13:59'); // Defaults to UTC
print(datetime); // Date (1972-07-25 21:13:59)
// year of era and era
print(datetime.format('YYYY GG')); // 1975 AD
// century and year
print(datetime.format('CC YY')); // 19 75
// weekyear and week of weekyear
print(datetime.format('xxxx ww')); // 1975 30
// year and day of year
print(datetime.format('yy DDD')); // 75 204
// month of year and day of month
print(datetime.format('MM dd')); // 07 23
// day of week number and day of week text
print(datetime.format('e E')); // 3 Wed
print(datetime.format('e EEEEEEEE')); // 3 Wednesday
// half of day, hour of halfday, and clockhour of halfday
print(datetime.format('a K h')); // PM 9 9
print(datetime.format('a KK hh')); // PM 09 09
// hour of day, clockhour of day, minute, second, fraction of second
print(datetime.format('H k m s S')); // 21 21 13 59 0
print(datetime.format('HH kk mm ss SS')); // 21 21 13 59 00
// time zone
print(datetime.format('z')); // UTC
print(datetime.format('zzzz')); // Coordinated Universal Time
print(datetime.format('z', 'PST8PDT')); // PDT
print(datetime.format('zzzz', 'PST8PDT')); // Pacific Daylight Time
// time zone offset/id
print(datetime.format('Z')); // +0000
print(datetime.format('ZZ')); // +00:00
print(datetime.format('ZZZ')); // UTC
print(datetime.format('Z', 'PST8PDT')); // -0700
print(datetime.format('ZZ', 'PST8PDT')); // -07:00
print(datetime.format('ZZZ', 'PST8PDT')); // PST8PDT
// single quotes for text
print(datetime.format("YY 'yada' MM")); // 75 yada 07
// '' for a single quote
print(datetime.format("YY ''MM'' dd")); // 75 '07' 23
Python 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# Various examples of ee.Date.format with Joda-Time formatting and time zones.
date = ee.Date('2020-08-18') # Defaults to UTC
display(date) # Date (2020-08-18 00:00:00)
# List of time zones:
# https://www.joda.org/joda-time/timezones.html
display(date.format(None, 'GMT')) # 2020-08-18T00:00:00
display(date.format(None, 'Etc/GMT')) # 2020-08-18T00:00:00
display(date.format(None, 'Etc/GMT+0')) # 2020-08-18T00:00:00
display(date.format(None, 'Zulu')) # 2020-08-18T00:00:00
display(date.format(None, 'UTC')) # 2020-08-18T00:00:00
display(date.format(None, 'America/Los_Angeles')) # 2020-08-17T17:00:00
display(date.format(None, 'US/Pacific')) # 2020-08-17T17:00:00
display(date.format(None, 'Etc/GMT+8')) # 2020-08-17T17:00:00
display(date.format(None, 'PST8PDT')) # 2020-08-17T17:00:00
display(date.format(None, 'Australia/Tasmania')) # 2020-08-18T10:00:00
display(date.format(None, 'Etc/GMT-10')) # 2020-08-18T10:00:00
# Reference for Joda-Time format characters:
# http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html
datetime = ee.Date('1975-07-23T21:13:59') # Defaults to UTC
display(datetime) # Date (1972-07-25 21:13:59)
# year of era and era
display(datetime.format('YYYY GG')) # 1975 AD
# century and year
display(datetime.format('CC YY')) # 19 75
# weekyear and week of weekyear
display(datetime.format('xxxx ww')) # 1975 30
# year and day of year
display(datetime.format('yy DDD')) # 75 204
# month of year and day of month
display(datetime.format('MM dd')) # 07 23
# day of week number and day of week text
display(datetime.format('e E')) # 3 Wed
display(datetime.format('e EEEEEEEE')) # 3 Wednesday
# half of day, hour of halfday, and clockhour of halfday
display(datetime.format('a K h')) # PM 9 9
display(datetime.format('a KK hh')) # PM 09 09
# hour of day, clockhour of day, minute, second, fraction of second
display(datetime.format('H k m s S')) # 21 21 13 59 0
display(datetime.format('HH kk mm ss SS')) # 21 21 13 59 00
# time zone
display(datetime.format('z')) # UTC
display(datetime.format('zzzz')) # Coordinated Universal Time
display(datetime.format('z', 'PST8PDT')) # PDT
display(datetime.format('zzzz', 'PST8PDT')) # Pacific Daylight Time
# time zone offset/id
display(datetime.format('Z')) # +0000
display(datetime.format('ZZ')) # +00:00
display(datetime.format('ZZZ')) # UTC
display(datetime.format('Z', 'PST8PDT')) # -0700
display(datetime.format('ZZ', 'PST8PDT')) # -07:00
display(datetime.format('ZZZ', 'PST8PDT')) # PST8PDT
# single quotes for text
display(datetime.format("YY 'yada' MM")) # 75 yada 07
# '' for a single quote
display(datetime.format("YY ''MM'' dd")) # 75 '07' 23
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[],["The `Date.format()` method converts a date to a string. It accepts a `format` string based on Joda-Time patterns and an optional `timeZone` string; if these arguments are omitted, the function will use default ISO formatting and UTC timezone. The method takes a date as input, and outputs a string representing the date, with specific formatting and time zone adjustments. The document also shows how to apply the formatting patterns.\n"],null,[]]