Auxiliares de tempo do $util.time

nota

Agora, oferecemos suporte principalmente ao tempo de execução APPSYNC _JS e sua documentação. Considere usar o tempo de execução APPSYNC _JS e seus guias aqui.

A variável $util.time contém métodos de data e hora para ajudar a gerar timestamps, converter entre formatos de data e hora e analisar strings de data e hora. A sintaxe dos formatos de data e hora é baseada na DateTimeFormatterqual você pode consultar para obter mais documentação. Abaixo fornecemos alguns exemplos, bem como uma lista dos métodos e descrições disponíveis.

Utilitários de tempo

Lista de utilitários de tempo

$util.time.nowISO8601() : String

Retorna uma representação String de UTC no formato ISO86 01.

$util.time.nowEpochSeconds() : long

Retorna o número de segundos desde epoch do 1970-01-01T00:00:00Z até agora.

$util.time.nowEpochMilliSeconds() : long

Retorna o número de milissegundos desde epoch do 1970-01-01T00:00:00Z até agora.

$util.time.nowFormatted(String) : String

Retorna uma string do timestamp atual UTC usando o formato especificado de um tipo de entrada String.

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

Retorna uma string do timestamp atual para um fuso horário usando o formato especificado e o fuso horário a partir de tipos de entrada String.

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

Analisa um timestamp enviado como uma string junto com um formato e retorna o timestamp como milissegundos desde o epoch.

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

Analisa um timestamp enviado como uma string junto com um formato e fuso horário e retorna o timestamp como milissegundos desde o epoch.

$util.time.parseISO8601ToEpochMilliSeconds(String) : Long

Analisa um carimbo de data/hora ISO86 01 passado como uma string e, em seguida, retorna o carimbo de data/hora em milissegundos desde a época.

$util.time.epochMilliSecondsToSeconds(long) : long

Converte um timestamp em milissegundos epoch em um timestamp em segundos epoch.

$util.time.epochMilliSecondsToISO8601(long) : String

Converte um carimbo de data/hora de milissegundos de época em um carimbo de data/hora de 0,1. ISO86

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

Converte um carimbo de data/hora de milissegundos de época, passado como longo, em um carimbo de data/hora formatado de acordo com o formato fornecido em. UTC

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

Converte um timestamp em milissegundos epoch enviado como um long em um timestamp formatado de acordo com o formato no fuso horário fornecido.

Exemplos de função autônoma

$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

Exemplos de conversão

#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

Exemplos de análise

$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

Uso com escalares AWS AppSync definidos

Os formatos a seguir são compatíveis com 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