Aiutanti temporali in $util.time

Nota

Ora supportiamo principalmente il runtime APPSYNC _JS e la relativa documentazione. Valuta la possibilità di utilizzare il runtime APPSYNC _JS e le relative guide qui.

La variabile $util.time contiene metodi datetime che consentono di generare timestamp, convertire i diversi formati datetime e analizzare le stringhe datetime. La sintassi per i formati datetime si basa sulla DateTimeFormatterquale puoi fare riferimento per ulteriore documentazione. Di seguito forniamo alcuni esempi, oltre a un elenco di metodi e descrizioni disponibili.

Utilità temporali

Elenco delle utilità temporali

$util.time.nowISO8601() : String

Restituisce una rappresentazione String di UTC in formato ISO86 01.

$util.time.nowEpochSeconds() : long

Restituisce il numero di secondi dall'epoca (Unix epoch) 1970-01-01T00:00:00Z a ora.

$util.time.nowEpochMilliSeconds() : long

Restituisce il numero di millisecondi dall'epoca (Unix epoch) 1970-01-01T00:00:00Z a ora.

$util.time.nowFormatted(String) : String

Restituisce una stringa del timestamp corrente UTC utilizzando il formato specificato da un tipo di input String.

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

Restituisce una stringa del timestamp corrente per un fuso orario utilizzando il formato e il fuso orario specificati da tipi di input stringa.

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

Analizza un timestamp passato come String insieme a un formato, quindi restituisce il timestamp in millisecondi dall'epoca.

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

Analizza un timestamp passato come String insieme a un formato e un fuso orario, quindi restituisce il timestamp in millisecondi dall'epoca.

$util.time.parseISO8601ToEpochMilliSeconds(String) : Long

Analizza un timestamp ISO86 01 passato come String, quindi restituisce il timestamp in millisecondi trascorsi da epoch.

$util.time.epochMilliSecondsToSeconds(long) : long

Converte un timestamp in formato epoca (Unix epoch) espresso in millisecondi in un timestamp in formato epoca (Unix epoch) espresso in secondi.

$util.time.epochMilliSecondsToISO8601(long) : String

Converte il timestamp di un'epoca in millisecondi in un timestamp 01. ISO86

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

Converte il timestamp di un'epoca in millisecondi, passato così a lungo, in un timestamp formattato secondo il formato fornito in. UTC

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

Converte il timestamp di un'epoca in millisecondi, passato come long, in un timestamp formattato secondo il formato fornito nel fuso orario fornito.

Esempi di funzioni autonome

$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

Esempi di conversione

#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

Esempi di analisi

$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

Utilizzo con scalari AWS AppSync definiti

I seguenti formati sono compatibili con AWSDate, AWSDateTime e 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