時間助手在 $ 實用時間

注意

我們現在主要支援 APPSYNC_JS 執行階段及其說明文件。請考慮在此處使用 APPSYNC_JS 執行階段及其指南。

$util.time 變數包含日期時間方法，可協助產生時間戳記、在日期時間格式之間轉換，以及剖析日期時間字串。日期時間格式的語法基於您可以參考DateTimeFormatter以獲取進一步的文檔。我們在下面提供了一些示例，以及可用的方法和描述的列表。

时间实用程序

時間實用程序列表

$util.time.nowISO8601() : String

以 ISO8601 格式傳回 UTC 的字串表示方式。

$util.time.nowEpochSeconds() : long

傳回從 1970-01-01T00:00:00Z 的 epoch 到現在的秒數。

$util.time.nowEpochMilliSeconds() : long

傳回從 1970-01-01T00:00:00Z 的 epoch 到現在的毫秒數。

$util.time.nowFormatted(String) : String

使用字串輸入類型的指定格式，傳回 UTC 中目前時間戳記的字串。

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

使用字串輸入類型的指定格式和時區，傳回時區目前時間戳記的字串。

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

解析作為字符串傳遞的時間戳以及格式，然後返回自 epoch 以毫秒為單位的時間戳。

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

解析作為字符串傳遞的時間戳以及格式和時區，然後返回自 epoch 以毫秒為單位的時間戳。

$util.time.parseISO8601ToEpochMilliSeconds(String) : Long

解析作為字符串傳遞的 ISO8601 時間戳，然後返回自紀元以毫秒為單位的時間戳。

$util.time.epochMilliSecondsToSeconds(long) : long

將 epoch 毫秒時間戳記轉換為 epoch 秒時間戳記。

$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

AWS 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