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á.

# Função TO\$1TIMESTAMP no Amazon QLDB
<a name="ql-functions.to_timestamp"></a>

**Importante**  
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

No Amazon QLDB, dada uma string que representa um timestamp, use a função `TO_TIMESTAMP` para converter a string em um tipo de dados `timestamp`. Esta é a operação inversa de `TO_STRING`.

## Sintaxe
<a name="ql-functions.to_timestamp.syntax"></a>

```
TO_TIMESTAMP ( string [, 'format' ] )
```

## Argumentos
<a name="ql-functions.to_timestamp.arguments"></a>

*string*  
O nome do campo ou a expressão do tipo de dados `string` que a função converte em um timestamp.

*format*  
(Opcional) A string literal que define o padrão de formato da entrada*string*, em termos de suas partes de data. Para obter os formatos válidos, consulte [Strings de formato da data e hora](ql-functions.timestamp-format.md).  
Se esse argumento for omitido, a função assume que o *string* está no formato de um timestamp [padrão](http://amzn.github.io/ion-docs/docs/spec.html#timestamp) do Ion. Essa é a maneira recomendada de analisar um timestamp do Ion usando essa função.  
O preenchimento zero é opcional ao usar um símbolo de formato de caractere único (como `y`, `M`, `d`, `H`, `h`, `m`, `s`), mas é obrigatório para suas variantes com preenchimento zero (como `yyyy`, `MM`, `dd`, `HH`, `hh`, `mm`, `ss`).  
Tratamento especial é dado aos anos de dois dígitos (símbolo de formato `yy`). 1900 é adicionado a valores maiores que ou iguais a 70 e 2000 é adicionado a valores menores que 70.  
Os nomes dos meses e os indicadores AM ou PM não diferenciam maiúsculas de minúsculas.

## Tipo de retorno
<a name="ql-functions.to_timestamp.return-type"></a>

`timestamp`

## Exemplos
<a name="ql-functions.to_timestamp.examples"></a>

```
TO_TIMESTAMP('2007T')                         -- `2007T`
TO_TIMESTAMP('2007-02-23T12:14:33.079-08:00') -- `2007-02-23T12:14:33.079-08:00`
TO_TIMESTAMP('2016', 'y')                     -- `2016T`
TO_TIMESTAMP('2016', 'yyyy')                  -- `2016T`
TO_TIMESTAMP('02-2016', 'MM-yyyy')            -- `2016-02T`
TO_TIMESTAMP('Feb 2016', 'MMM yyyy')          -- `2016-02T`
TO_TIMESTAMP('February 2016', 'MMMM yyyy')     -- `2016-02T`

-- Runnable statements
SELECT TO_TIMESTAMP('2007T') FROM << 0 >>              -- 2007T
SELECT TO_TIMESTAMP('02-2016', 'MM-yyyy') FROM << 0 >> -- 2016-02T
```

## Funções relacionadas
<a name="ql-functions.to_timestamp.related"></a>
+ [CAST](ql-functions.cast.md)
+ [DATE\$1ADD](ql-functions.date_add.md)
+ [DATE\$1DIFF](ql-functions.date_diff.md)
+ [EXTRACT](ql-functions.extract.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [UTCNOW](ql-functions.utcnow.md)