As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Auxiliares de tempo do \$1util.time
<a name="time-helpers-in-util-time"></a>

**nota**  
Agora, oferecemos suporte principalmente ao runtime do APPSYNC\$1JS e sua documentação. Considere usar o runtime do APPSYNC\$1JS e seus guias disponíveis [aqui](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html).

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

### Lista de utilitários de tempo
<a name="utility-helpers-in-time-list"></a>

** `$util.time.nowISO8601() : String` **  
Retorna uma representação em string do UTC no [ISO8601formato](https://en.wikipedia.org/wiki/ISO_8601).

** `$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 em UTC usando o formato especificado a partir 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 carimbo de data e hora passado como uma string com um formato contendo um fuso horário e, em seguida, retorna o carimbo de data e hora como milissegundos desde a época.

** `$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 ISO8601 carimbo de data/hora 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 timestamp de milissegundos de época em um timestamp. ISO8601

** `$util.time.epochMilliSecondsToFormatted(long, String) : String` **  
Converte um timestamp em milissegundos epoch enviado como long em um timestamp formatado de acordo com o formato 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
<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
```

## Exemplos de conversão
<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
```

## Exemplos de análise
<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
```

## Uso com escalares AWS AppSync definidos
<a name="usage-with-aws-scalars"></a>

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