此页面由 Cloud Translation API 翻译。

DateTime

JSON 表示法

JSON 表示法
{ "date": string }

字段

字段
`date`	`string` ISO 8601 扩展格式的日期/时间。可能需要偏移量，也可能不需要（请参阅父字段的文档）。时间最高可指定到纳秒级精度。偏移量可指定到秒级精度（虽然 ISO 8601 中未以秒为精度指定偏移量）。例如： `1985-04-12T23:20:50.52Z` 表示世界协调时间 (UTC) 1985 年 4 月 12 日 23 时 20 分 50.52 秒。 `1985-04-12T19:20:50.52-04:00` 表示比世界协调时间 (UTC) 早 4 个小时的 1985 年 4 月 12 日 19 时 20 分 50.52 秒（与上述示例的时间相同）。如果指定日期/时间对应的是纽约的实际位置，则此时间等同于美国东部夏令时间 (EDT)。请注意，在采用夏令时的地区，偏移量会有所不同，具体取决于一年中的不同时间。 `1985-04-12T19:20:50.52` 表示不带偏移量信息的 1985 年 4 月 12 日 19 时 20 分 50.52 秒。提供偏移量后，地球上发生的这个时间绝对是即时的。日期/时间将根据用户的时区进行调整。例如，对于纽约的用户，`2018-06-19T18:30:00-04:00` 时间为 18:30:00，对于洛杉矶的用户，时间为 15:30:00。如果省略偏移值，则该值为本地日期/时间，代表世界各地的多个时刻。日期/时间将始终采用用户当前的时区。例如，对于纽约的用户，`2018-06-19T18:30:00` 时间为 18:30:00，对于洛杉矶的用户，同样为 18:30:00。当相同的当地日期/时间应用于多个时区的多个实际位置时，这会非常有用。

date

string

ISO 8601 扩展格式的日期/时间。可能需要偏移量，也可能不需要（请参阅父字段的文档）。时间最高可指定到纳秒级精度。偏移量可指定到秒级精度（虽然 ISO 8601 中未以秒为精度指定偏移量）。

例如：

1985-04-12T23:20:50.52Z 表示世界协调时间 (UTC) 1985 年 4 月 12 日 23 时 20 分 50.52 秒。

1985-04-12T19:20:50.52-04:00 表示比世界协调时间 (UTC) 早 4 个小时的 1985 年 4 月 12 日 19 时 20 分 50.52 秒（与上述示例的时间相同）。如果指定日期/时间对应的是纽约的实际位置，则此时间等同于美国东部夏令时间 (EDT)。请注意，在采用夏令时的地区，偏移量会有所不同，具体取决于一年中的不同时间。

1985-04-12T19:20:50.52 表示不带偏移量信息的 1985 年 4 月 12 日 19 时 20 分 50.52 秒。

提供偏移量后，地球上发生的这个时间绝对是即时的。日期/时间将根据用户的时区进行调整。例如，对于纽约的用户，2018-06-19T18:30:00-04:00 时间为 18:30:00，对于洛杉矶的用户，时间为 15:30:00。

如果省略偏移值，则该值为本地日期/时间，代表世界各地的多个时刻。日期/时间将始终采用用户当前的时区。例如，对于纽约的用户，2018-06-19T18:30:00 时间为 18:30:00，对于洛杉矶的用户，同样为 18:30:00。当相同的当地日期/时间应用于多个时区的多个实际位置时，这会非常有用。