Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

TO_TIMESTAMP_TZ

TO_TIMESTAMP_TZ

Converte uma string em um valor de Registro de data/hora com Fuso Horário. A função retorna o tipo de dados de Registro de data/hora com Fuso Horário. Use as strings de formato TO_TIMESTAMP_TZ para especificar o formato das strings de origem.

Sintaxe

TO_TIMESTAMP_TZ (
String
, [
format
] )
A tabela a seguir descreve os argumentos para este comando:
Argumento
Obrigatório/
Opcional
Descrição
String
Obrigatório
Deve ser um tipo de dados de string. Transmite os valores que você deseja converter em Registro de data/hora com Fuso Horário. Você pode inserir qualquer expressão válida de transformação.
A string deve ser uma string de caracteres.
formato
Opcional
Insira uma string válida de formato TO_TIMESTAMP_TZ. A string de formato deve corresponder às partes do argumento string. Por exemplo, se você transmitir a string "Mar 15 1997 12:43:10AM ASIA/CALCUTTA", deverá usar a string de formato "MON DD YYYY HH12:MI:SSAM TZR".
Se você não especificar a string de formato, a função usará o formato padrão de data e hora na caixa de diálogo Executar Configurações.

Valor de Retorno

Retorna um tipo de dados de registro de data/hora com fuso horário.
NULL se a entrada for um valor nulo.
Se o valor transmitido para a função contiver dados inválidos para um valor de registro de data/hora com fuso horário, o Serviço de Integração de Dados marcará a linha como uma linha de erro e emitirá uma falha no mapeamento.
Exemplo
INPUT VALUE
RETURN VALUE
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM TZR'
Retorna um tipo de dados de registro de data/hora com fuso horário com os seguintes dados:
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES’
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM'
Retorna um tipo de dados de registro de data/hora com fuso horário, mesmo sem especificar a região de fuso horário no formato da região de fuso horário:
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’
Retorna um tipo de dados de registro de data/hora com fuso horário, mesmo sem especificar o formato de registro de data/hora com fuso horário.
'1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
O formato de data e hora padrão na caixa de diálogo Executar Configurações é usado quando o formato não é especificado no nível da função.
Formato de data e hora padrão:
'YYYY-MM-DD HH:MI:SS.NS AM TZR'
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, ’MM-DD-YYYY HH:MI:SS.NS AM'
Se um registro de data/hora com fuso horário não corresponder ao formato especificado, o seguinte erro aparecerá:
Process row failed for function [TO_TIMESTAMP_TZ]: Failed to convert the string to timestamp with time zone value. Verify that the specified date format string is valid. Verify that the timestamp with time zone string used in the first argument is compatible with the specified date format.