Aplicaciones auxiliares de tiempo en $util.time

nota

Ahora admitimos de forma básica el tiempo de ejecución APPSYNC_JS y su documentación. Considere la opción de utilizar el tiempo de ejecución APPSYNC_JS y sus guías aquí.

La variable $util.time contiene métodos de fecha y hora útiles para ayudar a generar marcas de tiempo, convertir entre formatos de fecha y hora y analizar cadenas de fecha y hora. La sintaxis de los formatos de fecha y hora se basa en ella y puede DateTimeFormatterconsultarla para obtener más documentación. A continuación se ofrecen algunos ejemplos, así como una lista de métodos disponibles y sus descripciones.

Utilidades de tiempo

Lista de utilidades de tiempo

$util.time.nowISO8601() : String

Devuelve una representación de cadena de la hora UTC en formato ISO8601.

$util.time.nowEpochSeconds() : long

Devuelve el número de segundos desde la fecha de inicio de 1970-01-01T00:00:00Z hasta ahora.

$util.time.nowEpochMilliSeconds() : long

Devuelve el número de milisegundos desde la fecha de inicio de 1970-01-01T00:00:00Z hasta ahora.

$util.time.nowFormatted(String) : String

Devuelve una cadena con la marca de tiempo actual en UTC utilizando el formato especificado en un tipo de entrada String.

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

Devuelve una cadena con la marca de tiempo actual de una zona horaria utilizando el formato y la zona horaria especificados en tipos de entrada String.

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

Analiza una marca de tiempo pasada como String junto con un formato y, a continuación, devuelve la marca de tiempo como milisegundos transcurridos desde la fecha de inicio.

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

Analiza una marca de tiempo pasada como String junto con un formato y una zona horaria y, a continuación, la devuelve como milisegundos transcurridos desde la fecha de inicio.

$util.time.parseISO8601ToEpochMilliSeconds(String) : Long

Analiza una marca de tiempo ISO8601 pasada como String y, a continuación, la devuelve como milisegundos transcurridos desde la fecha de inicio.

$util.time.epochMilliSecondsToSeconds(long) : long

Convierte una marca de tiempo en milisegundos desde la fecha de inicio en una marca de tiempo en segundos de la fecha de inicio.

$util.time.epochMilliSecondsToISO8601(long) : String

Convierte una marca de tiempo en milisegundos desde la fecha de inicio en una marca de tiempo ISO8601.

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

Convierte una marca de tiempo en milisegundos desde la fecha de inicio, pasada como tipo long, en una marca de tiempo UTC con el formato suministrado.

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

Convierte una marca de tiempo en milisegundos desde la fecha de inicio, pasada como tipo long, en una marca de tiempo para la zona horaria y con el formato suministrados.

Ejemplos de funciones independientes

$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

Ejemplos de conversión

#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

Ejemplos de análisis

$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 con escalares definidos AWS AppSync

Los siguientes formatos son compatibles con AWSDate, AWSDateTime y 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