$util.time 中的时间帮助程序 - Amazon AppSync
时间实用程序单独函数示例转换示例解析示例与 Amazon AppSync 定义的标量一起使用
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

$util.time 中的时间帮助程序

注意

我们现在主要支持 APPSYNC_JS 运行时环境及其文档。请考虑使用 APPSYNC_JS 运行时环境和此处的指南。

$util.time 变量包含的日期时间方法有助于生成时间截，在不同的日期时间格式之间进行转换，并解析日期时间字符串。日期时间格式的语法基于 DateTimeFormatter，您可参考其他文档，进一步了解此内容。我们在下面提供了一些示例以及可用方法和描述列表。

时间实用程序

$util.time.nowISO8601() : String

返回 UTC 的 ISO8601 格式字符串表示形式。

$util.time.nowEpochSeconds() : long

返回从 1970-01-01T00:00:00Z 纪元到现在的秒数。

$util.time.nowEpochMilliSeconds() : long

返回从 1970-01-01T00:00:00Z 纪元到现在的毫秒数。

$util.time.nowFormatted(String) : String

使用字符串输入类型指定的格式返回当前 UTC 时间戳的字符串。

$util.time.nowFormatted(String, String) : String

使用字符串输入类型指定的格式和时区返回该时区当前时间戳的字符串。

$util.time.parseFormattedToEpochMilliSeconds(String, String) : Long

解析作为字符串传递的时间戳以及格式，然后将时间戳作为自纪元以来的毫秒数返回。

$util.time.parseFormattedToEpochMilliSeconds(String, String, String) : Long

解析作为字符串传递的时间戳以及格式和时区，然后将时间戳作为自纪元以来的毫秒数返回。

$util.time.parseISO8601ToEpochMilliSeconds(String) : Long

解析作为字符串传递的 ISO8601 时间戳，然后将时间戳作为自纪元以来的毫秒数返回。

$util.time.epochMilliSecondsToSeconds(long) : long

将纪元毫秒数时间戳转换为纪元秒数时间戳。

$util.time.epochMilliSecondsToISO8601(long) : String

将纪元毫秒数时间戳转换为 ISO8601 时间戳。

$util.time.epochMilliSecondsToFormatted(long, String) : String

将以长型形式传递的纪元毫秒数时间戳转换为根据提供的 UTC 格式设置的时间戳。

$util.time.epochMilliSecondsToFormatted(long, String, String) : String

将以长型形式传递的纪元毫秒数时间戳转换为根据提供的时区和格式设置的时间戳。

单独函数示例

$util.time.nowISO8601()                                            : 2018-02-06T19:01:35.749Z
$util.time.nowEpochSeconds()                                       : 1517943695
$util.time.nowEpochMilliSeconds()                                  : 1517943695750
$util.time.nowFormatted("yyyy-MM-dd HH:mm:ssZ")                    : 2018-02-06 19:01:35+0000
$util.time.nowFormatted("yyyy-MM-dd HH:mm:ssZ", "+08:00")          : 2018-02-07 03:01:35+0800
$util.time.nowFormatted("yyyy-MM-dd HH:mm:ssZ", "Australia/Perth") : 2018-02-07 03:01:35+0800

转换示例

#set( $nowEpochMillis = 1517943695758 )
$util.time.epochMilliSecondsToSeconds($nowEpochMillis)                                     : 1517943695
$util.time.epochMilliSecondsToISO8601($nowEpochMillis)                                     : 2018-02-06T19:01:35.758Z
$util.time.epochMilliSecondsToFormatted($nowEpochMillis, "yyyy-MM-dd HH:mm:ssZ")           : 2018-02-06 19:01:35+0000
$util.time.epochMilliSecondsToFormatted($nowEpochMillis, "yyyy-MM-dd HH:mm:ssZ", "+08:00") : 2018-02-07 03:01:35+0800

解析示例

$util.time.parseISO8601ToEpochMilliSeconds("2018-02-01T17:21:05.180+08:00")                          : 1517476865180
$util.time.parseFormattedToEpochMilliSeconds("2018-02-02 01:19:22+0800", "yyyy-MM-dd HH:mm:ssZ")     : 1517505562000
$util.time.parseFormattedToEpochMilliSeconds("2018-02-02 01:19:22", "yyyy-MM-dd HH:mm:ss", "+08:00") : 1517505562000

与 Amazon AppSync 定义的标量一起使用

以下格式与 AWSDate、AWSDateTime 和 AWSTime 兼容。

$util.time.nowFormatted("yyyy-MM-dd[XXX]", "-07:00:30")               : 2018-07-11-07:00
$util.time.nowFormatted("yyyy-MM-dd'T'HH:mm:ss[XXXXX]", "-07:00:30")  : 2018-07-11T15:14:15-07:00:30