Função CAST

CAST é uma função complexa que transforma um ou mais valores de um tipo de dados para outro.

SINTAXE

Nota: Na prática, não é possível especificar todos os parâmetros acima ao mesmo tempo. Por exemplo, as expressões CCSID e ENCODING têm efeito apenas em conversões entre cadeias, enquanto FORMAT aplica-se apenas às conversões entre cadeia e numérico e entre cadeia e data/hora (em qualquer direção).

CAST transforma um ou mais valores de um tipo de dados para outro. Por exemplo, você pode utilizar CAST para processar mensagens XML genéricas. Todos os campos em uma mensagem XML possuem valores de caracteres, portanto, por exemplo, se você desejasse desempenhar um cálculo aritmético ou uma comparação de data/hora em um campo, poderia utilizar CAST para converter o valor da cadeia do campo em um valor do tipo apropriado.

Nem todas as conversões são suportadas; consulte Coerções Suportadas para obter uma lista de conversões suportadas.

Parâmetros

Expressão de Origem

CAST retorna seu primeiro parâmetro (source_expression), que pode conter mais de um valor, como o tipo de dados especificado por seu segundo parâmetro (DataType). Em todos os casos, se a expressão de origem for NULL, o resultado será NULL. Se a expressão de origem avaliada não for compatível com o tipo de dados de destino, ou se a expressão de origem tiver o formato incorreto, será gerado um erro de tempo de execução.

CCSID

A cláusula CCSID é utilizada apenas para conversões para/de um dos tipos de dados de cadeia. Ela permite especificar a página de códigos da cadeia de origem ou de destino.

A expressão CCSID pode ser qualquer expressão que seja avaliada como um valor de tipo INT. É interpretada de acordo com a regras normais do WebSphere Message Broker para CCSIDs.Consulte Páginas de Códigos Suportadas para obter uma lista de valores válidos.

DataType

DataType é o tipo de dados para o qual o valor de origem será transformado. Os valores possíveis são:
  • Tipos de cadeia:
    • BIT
    • BLOB
    • CHARACTER
  • Tipos numéricos:
    • DECIMAL
    • FLOAT
    • INTEGER
  • Tipos de data/hora:
    • DATE
    • GMTTIME
    • GMTTIMESTAMP
    • INTERVAL
    • TIME
    • TIMESTAMP
  • Booleano:
    • BOOLEAN

DEFAULT

A cláusula DEFAULT fornece um método para evitar que exceções sejam emitidas de instruções CAST, fornecendo um valor de último recurso para o retorno.

A DEFAULT expression deve ser uma expressão ESQL válida que retorne o mesmo tipo de dados que aquele especificado no parâmetro DataType, caso contrário, uma exceção é emitida.

Os parâmetros CCSID, ENCODING e FORMAT não são aplicados ao resultado da expressão DEFAULT; portanto, a expressão deve ser do CCSID, ENCODING e FORMAT corretos.

ENCODING

A cláusula ENCODING permite especificar a codificação. É utilizada apenas para determinadas conversões. O valor ENCODING pode ser qualquer expressão que seja avaliada como um valor de tipo INT. É interpretada de acordo com as regras normais de codificação do WebSphere Message Broker.Os valores válidos são:
  • MQENC_NATIVE (0x00000222L)
  • MQENC_INTEGER_NORMAL (0x00000001L)
  • MQENC_INTEGER_REVERSED (0x00000002L)
  • MQENC_DECIMAL_NORMAL (0x00000010L)
  • MQENC_DECIMAL_REVERSED (0x00000020L)
  • MQENC_FLOAT_IEEE_NORMAL (0x00000100L)
  • MQENC_FLOAT_IEEE_REVERSED (0x00000200L)
  • MQENC_FLOAT_S390 (0x00000300L)

FORMAT

Para conversões entre tipos de dados de cadeia e tipos de dados numéricos ou de data/hora, você pode fornecer uma expressão FORMAT opcional. Para conversões de tipos de cadeia, FORMAT define como a cadeia de origem deve ser analisada para preencher o tipo de dados de destino. Para conversões para tipos de cadeia, define como os dados na expressão de origem devem ser formatados na cadeia de destino.

FORMAT suporta diferentes tipos de expressão para conversões de data/hora e numéricas. Entretanto, a mesma expressão FORMAT pode ser utilizada independentemente se a conversão é para uma cadeia ou de uma cadeia.

Você pode especificar uma expressão FORMAT na coerção:
  • De qualquer um dos tipos de dados de cadeia (BIT, BLOB ou CHARACTER) para:
    • DECIMAL
    • FLOAT
    • INTEGER
    • DATE
    • GMTTIMESTAMP
    • TIMESTAMP
    • GMTTIME
    • TIME
  • Para qualquer um dos tipos de dados de cadeia (BIT, BLOB ou CHARACTER), a partir de qualquer um dos tipos de dados numéricos e de data/hora atendidos no marcador anterior.
Especificar FORMAT para uma combinação não suportada dos tipos de dados de origem e de destino faz com que a mensagem de erro BIP3205 seja emitida.

Para obter informações adicionais sobre a conversão para/de tipos de dados numéricos, consulte Formatando e Analisando Números como Cadeias. Para obter informações adicionais sobre a conversão para/de tipos de dados de data/hora, consulte Formatando e Analisando dateTimes como Cadeias.

A expressão FORMAT é equivalente àquelas utilizadas em vários outros produtos, como ICU e Microsoft Excel.

Exemplos

Exemplo 1. CAST Formatado de DECIMAL para CHARACTER

DECLARE source DECIMAL 31415.92653589;
DECLARE target CHARACTER;
DECLARE pattern CHARACTER '#,##0.00';
SET target = CAST(source AS CHARACTER FORMAT pattern);
-- agora o destino é "31.415,93"

Exemplo 2. CAST Formatado de DATE para CHARACTER

DECLARE now CHARACTER = CAST(CURRENT_TIMESTAMP AS CHARACTER
                        FORMAT "yyyyMMdd-HHmmss");
-- agora o destino é "20041007-111656" (nesta instância, pelo menos)

Exemplo 3. CAST Formatado de CHARACTER para DATE

DECLARE source CHARACTER '01-02-03';
DECLARE target DATE;
DECLARE pattern CHARACTER 'dd-MM-yy';
SET target = CAST(source AS DATE FORMAT pattern);
-- agora o destino contém Ano=2003, Mês=02, Dia=01

Exemplo 4. CAST Formatado de CHARACTER para TIMESTAMP

DECLARE source CHARACTER '12 Jan 03, 3:45pm';
DECLARE target TIMESTAMP;
DECLARE pattern CHARACTER 'dd MMM yy, h:mma';
SET target = CAST(source AS TIMESTAMP FORMAT pattern);
-- agora o destino contém Ano=2003, Mês=01, Dia=03, Hora=15, Minuto=45,
                       Segundos=58
-- (segundos extraídos de CURRENT_TIME porque não estão presentes na entrada)

Exemplo 5. CAST Formatado de DECIMAL para CHARACTER, com Padrão Negativo

DECLARE source DECIMAL -54231.122;
DECLARE target CHARACTER;
DECLARE pattern CHARACTER '#,##0.00;(#,##0.00)';
SET target = CAST(source AS CHARACTER FORMAT pattern);
-- agora o destino é "£(54.231,12)"

Exemplo 6. CAST Formatado de CHARACTER para TIME

DECLARE source CHARACTER '16:18:30';
DECLARE target TIME;
DECLARE pattern CHARACTER 'hh:mm:ss';
SET target = CAST(source AS TIME FORMAT pattern);
-- agora o destino contém Hora=16, Minuto=18, Segundos=30

Exemplo 7. CASTs dos Tipos Numéricos para DATE

CAST(7, 6, 5 AS DATE);
CAST(7.4e0, 6.5e0, 5.6e0 AS DATE);
CAST(7.6, 6.51, 5.4 AS DATE);

Exemplo 8. CASTs dos Tipos Numéricos para TIME

CAST(9, 8, 7 AS TIME);
CAST(9.4e0, 8.6e0, 7.1234567e0 AS TIME);
CAST(9.6, 8.4, 7.7654321 AS TIME);

Exemplo 9. CASTs dos Tipos Numéricos para GMTTIME

CAST(DATE '0001-02-03', TIME '04:05:06' AS TIMESTAMP);
CAST(2, 3, 4, 5, 6, 7.8 AS TIMESTAMP);

Exemplo 10. CASTs para TIMESTAMP

CAST(DATE '0001-02-03', TIME '04:05:06' AS TIMESTAMP);
CAST(2, 3, 4, 5, 6, 7.8 AS TIMESTAMP);

Exemplo 11. CASTs para GMTTIMESTAMP

CAST(DATE '0002-03-04', GMTTIME '05:06:07' AS GMTTIMESTAMP);
CAST(3, 4, 5, 6, 7, 8 AS GMTTIMESTAMP);
CAST(3.1e0, 4.2e0, 5.3e0, 6.4e0, 7.5e0, 8.6789012e0 AS GMTTIMESTAMP);
CAST(3.2, 4.3, 5.4, 6.5, 7.6, 8.7890135 AS GMTTIMESTAMP);

Exemplo 12. CASTs para INTERVAL de INTEGER

CAST(1234 AS INTERVAL YEAR);
CAST(32, 10 AS INTERVAL YEAR   TO MONTH );
CAST(33, 11 AS INTERVAL DAY    TO HOUR  );
CAST(34, 12 AS INTERVAL HOUR   TO MINUTE);
CAST(35, 13 AS INTERVAL MINUTE TO SECOND);
CAST(36, 14, 10  AS INTERVAL DAY  TO MINUTE);
CAST(37, 15, 11  AS INTERVAL HOUR TO SECOND);
CAST(38, 16, 12, 10 AS INTERVAL DAY TO SECOND);

Exemplo 13. CASTs para INTERVAL de FLOAT

CAST(2345.67e0   AS INTERVAL YEAR  );
CAST(3456.78e1   AS INTERVAL MONTH );
CAST(4567.89e2   AS INTERVAL DAY   );
CAST(5678.90e3   AS INTERVAL HOUR  );
CAST(6789.01e4   AS INTERVAL MINUTE);
CAST(7890.12e5   AS INTERVAL SECOND);
CAST(7890.1234e0 AS INTERVAL SECOND);

Exemplo 14. CASTs para INTERVAL de DECIMAL

CAST(2345.67   AS INTERVAL YEAR  );
CAST(34567.8   AS INTERVAL MONTH );
CAST(456789    AS INTERVAL DAY   );
CAST(5678900   AS INTERVAL HOUR  );
CAST(67890100  AS INTERVAL MINUTE);
CAST(789012000 AS INTERVAL SECOND);
CAST(7890.1234 AS INTERVAL SECOND);

Exemplo 15. CASTs para FLOAT de INTERVAL

CAST(INTERVAL '1234' YEAR   AS FLOAT);
CAST(INTERVAL '2345' MONTH  AS FLOAT);
CAST(INTERVAL '3456' DAY    AS FLOAT);
CAST(INTERVAL '4567' HOUR   AS FLOAT);
CAST(INTERVAL '5678' MINUTE AS FLOAT);
CAST(INTERVAL '6789.01' SECOND AS FLOAT);

Exemplo 16. CASTs DECIMAL de INTERVAL

CAST(INTERVAL '1234' YEAR   AS DECIMAL);
CAST(INTERVAL '2345' MONTH  AS DECIMAL);
CAST(INTERVAL '3456' DAY    AS DECIMAL);
CAST(INTERVAL '4567' HOUR   AS DECIMAL);
CAST(INTERVAL '5678' MINUTE AS DECIMAL);
CAST(INTERVAL '6789.01' SECOND AS DECIMAL);

Exemplo 17. Uma Coerção Ternária que Falha e Resulta na Substituição de um Valor Padrão

CAST(7, 6, 32 AS DATE DEFAULT DATE '1947-10-24');

Exemplo 18. Uma Coerção Sexternária que Falha e Resulta na Substituição de um Valor Padrão

CAST(2, 3, 4, 24, 6, 7.8 AS TIMESTAMP DEFAULT TIMESTAMP '1947-10-24 07:08:09');

Exemplo 19. Uma Coerção Ternária que Falha e Emite uma Exceção

  BEGIN
  DECLARE EXIT HANDLER FOR SQLSTATE LIKE '%' BEGIN
    SET OutputRoot.XML.Data.Date.FromIntegersInvalidCast = 'Exception thrown';
          END;

  DECLARE Dummy CHARACTER CAST(7, 6, 32 AS DATE);
    END;

Exemplo 20. Uma Coerção Sexternária que Falha e Emite uma Exceção

  BEGIN
  DECLARE EXIT HANDLER FOR SQLSTATE LIKE '%' BEGIN
    SET OutputRoot.XML.Data.Timestamp.FromIntegersInvalidCast = 'Exception thrown';
          END;

  DECLARE Dummy CHARACTER CAST(2, 3, 4, 24, 6, 7.8 AS TIMESTAMP);
    END;
Conceitos relacionados
Visão Geral do ESQL
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ak05610_