Funções de conversão¶

Lista de funções¶

Funções de conversão de tratamento de erros¶

As funções de conversão com um prefixo TRY_ são versões especiais de suas respectivas funções de conversão. Essas funções retornam um valor NULL em vez de apresentar um erro quando a conversão não pode ser realizada:

• TRY_CAST

• TRY_TO_BINARY

• TRY_TO_BOOLEAN

• TRY_TO_DATE

• TRY_TO_DECIMAL, TRY_TO_NUMBER, TRY_TO_NUMERIC

• TRY_TO_DOUBLE

• TRY_TO_GEOGRAPHY

• TRY_TO_GEOMETRY

• TRY_TO_TIME

• TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_*

Observe que essas funções aceitam apenas expressões de cadeia de caracteres (isto é, tipo de dados VARCHAR ou CHAR) como entrada.

Formatos numéricos em funções de conversão¶

As funções TO_DECIMAL , TO_NUMBER , TO_NUMERIC e TO_DOUBLE aceitam um parâmetro opcional que especifica o formato da cadeia de caracteres de entrada, se a expressão de entrada avaliar para uma cadeia de caracteres. Para obter mais informações sobre os valores que esse parâmetro pode ter, consulte Modelos de formato SQL.

Formatos de data e hora em funções de conversão¶

As funções a seguir permitem especificar a data, hora ou formato de carimbo de data/hora esperado para analisar ou produzir uma cadeia de caracteres:

• TO_CHAR , TO_VARCHAR

• TO_DATE , DATE

• TRY_TO_DATE

• TO_TIME , TIME

• TRY_TO_TIME

• TO_TIMESTAMP / TO_TIMESTAMP_*

• TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_*

Você especifica o formato em um argumento opcional, usando os seguintes elementos que não diferenciam maiúsculas e minúsculas para descrever o formato:

SELECT TO_DATE('3/4/2013', 'dd/mm/yyyy');

-----------------------------------+
 to_date('3/4/2013', 'dd/mm/yyyy') |
-----------------------------------+
 2013-04-03                        |
-----------------------------------+

SELECT TO_VARCHAR('2013-04-05'::date, 'mon dd, yyyy');

------------------------------------------------+
 to_varchar('2013-04-05'::date, 'mon dd, yyyy') |
------------------------------------------------+
 Apr 05, 2013                                   |
------------------------------------------------+

Formatos binários em funções de conversão¶

TO_CHAR , TO_VARCHAR e TO_BINARY aceitam um argumento opcional especificando o formato esperado para analisar ou produzir uma cadeia de caracteres.

O formato pode ser uma das seguintes cadeias de caracteres (sem distinção de maiúsculas e minúsculas):

• HEX

• BASE64

• UTF-8

Para obter mais informações sobre esses formatos, consulte Overview of Supported Binary Formats.

Para obter exemplos de utilização desses formatos, consulte a seção de exemplos de Binary Input and Output.