$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