Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Aplicaciones auxiliares de tiempo en \$1util.time
<a name="time-helpers-in-util-time"></a>

**nota**  
Ahora admitimos de forma básica el tiempo de ejecución APPSYNC\$1JS y su documentación. Considere la opción de utilizar el tiempo de ejecución APPSYNC\$1JS y sus guías [aquí](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html).

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 [DateTimeFormatter](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html)consultarla 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
<a name="utility-helpers-in-time"></a>

### Lista de utilidades de tiempo
<a name="utility-helpers-in-time-list"></a>

** `$util.time.nowISO8601() : String` **  
[Devuelve una representación en cadena de UTC en ISO8601 formato String.](https://en.wikipedia.org/wiki/ISO_8601)

** `$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 cadena junto con un formato que contiene una zona horaria y, a continuación, la devuelve como milisegundos transcurridos desde la fecha de inicio.

** `$util.time.parseFormattedToEpochMilliSeconds(String, String, String) : Long` **  
Analiza una marca de tiempo pasada como cadena 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 ISO8601 marca de tiempo pasada como cadena y, a continuación, devuelve la marca de tiempo en milisegundos desde la época.

** `$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 de milisegundos de época 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
<a name="standalone-function-examples"></a>

```
$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
<a name="conversion-examples"></a>

```
#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
<a name="parsing-examples"></a>

```
$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 Uso con escalares definidos
<a name="usage-with-aws-scalars"></a>

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
```