O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função TO\$1TIMESTAMP
<a name="r_TO_TIMESTAMP"></a>

TO\$1TIMESTAMP converte uma string de TIMESTAMP em TIMESTAMPTZ. Para obter uma lista de funções adicionais de data e hora para o Amazon Redshift, consulte [Perfis de data e hora](Date_functions_header.md).

## Sintaxe
<a name="r_TO_TIMESTAMP-syntax"></a>

```
to_timestamp(timestamp, format)
```

```
to_timestamp (timestamp, format, is_strict)
```

## Argumentos
<a name="r_TO_TIMESTAMP-arguments"></a>

*timestamp*  
Uma string que representa um valor de timestamp no formato especificado por *format*. Se esse argumento for deixado vazio, o valor padrão de timestamp será `0001-01-01 00:00:00`.

*formato*  
Um literal de string que define o formato do valor de *timestamp*. Formatos que incluem um fuso horário (**TZ**, **tz** ou **OF**) não têm suporte como entrada. Para os formatos de timestamp válidos, consulte [Strings de formato datetime](r_FORMAT_strings.md).

*is\$1strict*  
Um valor booleano opcional que especifica se um erro será retornado se um valor de timestamp de entrada estiver fora do intervalo. Quando *is\$1strict* for definido como TRUE, um erro será retornado se houver um valor fora do intervalo. Quando *is\$1strict* estiver definido como FALSE, que é o padrão, então os valores de estouro são aceitos.

## Tipo de retorno
<a name="r_TO_TIMESTAMP-return-type"></a>

TIMESTAMPTZ

## Exemplos
<a name="r_TO_TIMESTAMP-examples"></a>

O exemplo a seguir mostra como usar a função TO\$1TIMESTAMP para converter uma string TIMESTAMP em TIMESTAMPTZ. 

```
select sysdate, to_timestamp(sysdate, 'YYYY-MM-DD HH24:MI:SS') as second;

timestamp                  | second
--------------------------   ----------------------
2021-04-05 19:27:53.281812 | 2021-04-05 19:27:53+00
```

É possível enviar parte de uma data com TO\$1TIMESTAMP. As partes restantes da data são definidas como valores padrão. A hora é incluída na saída:

```
SELECT TO_TIMESTAMP('2017','YYYY');

to_timestamp
--------------------------
2017-01-01 00:00:00+00
```

A seguinte instrução SQL converte a string “2011-12-18 24:38:15” para um TIMESTAMPTZ. O resultado é um TIMESTAMPTZ que cai no dia seguinte porque o número de horas é superior a 24 horas:

```
SELECT TO_TIMESTAMP('2011-12-18 24:38:15', 'YYYY-MM-DD HH24:MI:SS');
         
to_timestamp
----------------------
2011-12-19 00:38:15+00
```

A seguinte instrução SQL converte a string “2011-12-18 24:38:15” para um TIMESTAMPTZ. O resultado é um erro porque o valor de hora no timestamp é superior a 24 horas:

```
SELECT TO_TIMESTAMP('2011-12-18 24:38:15', 'YYYY-MM-DD HH24:MI:SS', TRUE);
         
ERROR:  date/time field time value out of range: 24:38:15.0
```