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

Strings de formato TO_CHAR

Strings de formato TO_CHAR

A função TO_CHAR converte um tipo de dados Data/Hora em uma string com o formato que você especificar. Você pode converter a data completa ou uma parte da data em uma string. Você pode usar TO-CHART para converter datas em strings, alterando o formato para fins de geração de relatório.
TO_CHAR é geralmente usado quando o destino é um arquivo plano ou um banco de dados que não oferece suporte a um tipo de dados Data/Hora.
A seguinte tabela resume as strings de formato para datas na função TO_CHAR:
String de Formato
Descrição
AM, A.M.
PM, P.M.
Indicador de meridiano. Use qualquer um destas strings de formato para especificar horas AM e PM. AM e PM retornam os mesmos valores que A.M. e P.M.
D
Dia da semana (1 - 7), em que domingo é igual a 1.
DAY
Nome do dia com até nove caracteres (por exemplo, Quarta).
DD
Dia do mês (01 - 31).
DDD
Dia do ano (001 - 366, incluindo anos bissextos).
DY
Nome abreviado com três caracteres para um dia (por exemplo, Qua).
HH, HH12
Hora do dia (01 - 12).
HH24
Hora do dia (00 - 23), em que 00 é 12AM (meia-noite).
J
Dia juliano modificado. Converte a data do calendário em uma string equivalente ao seu valor como dia juliano modificado, calculado a partir de 1° de janeiro de 4713 00:00:00 a.C., que ignora o componente de hora da data. Por exemplo, a expressão TO_CHAR( SHIP_DATE, ‘J’ ) converte 31 de dezembro de 1999 23:59:59 na string 2451544.
MI
Minutos (00 - 59).
MM
Mês (01 - 12).
MONTH
Nome do mês com até nove caracteres (por exemplo, janeiro).
MON
Nome abreviado com três caracteres para um mês (por exemplo, jan).
MS
Milissegundos (0 - 999).
NS
Nanossegundos (0 - 999999999).
Trim.
Trimestre do ano (1 - 4), em que janeiro a março é igual a 1.
RR
Os dois últimos dígitos de um ano. A função remove os dígitos à esquerda. Por exemplo, se você usar ‘RR’ e passar o ano 1997, TO_CHAR retornará 97. Quando usado com TO_CHAR, ‘RR’ produz os mesmos resultados que ‘YY’ e pode ser trocado por ‘YY’. No entanto, quando usado com TO_DATE, ‘RR’ calcula o século apropriado mais próximo e fornece os dois primeiros dígitos do ano.
SS
Segundos (00 - 59).
SSSSS
Segundos desde a meia-noite (00000 - 86399). Quando você usa SSSSS em uma expressão TO_CHAR, o
Serviço de Integração do PowerCenter
avalia apenas a hora de uma data. Por exemplo, a expressão TO_CHAR(SHIP_DATE, ‘MM/DD/YYYY SSSSS’) converte 12/31/1999 01:02:03 em 12/31/1999 03723.
US
Microssegundos (0 - 999999).
Ano
O último dígito de um ano. A função remove os dígitos à esquerda. Por exemplo, se você usar ‘Y’ e passar o ano 1997, TO_CHAR retornará 7.
YY
Os dois últimos dígitos de um ano. A função remove os dígitos à esquerda. Por exemplo, se você usar ‘YY’ e passar o ano 1997, TO_CHAR retornará 97.
YYY
Os três últimos dígitos de um ano. A função remove os dígitos à esquerda. Por exemplo, se você usar ‘YYY’ e passar o ano 1997, TO_CHAR retornará 997.
YYYY
Toda a parte do ano da data. Por exemplo, se você usar ‘YYYY’ e passar o ano 1997, TO_CHAR retornará 1997.
W
Semana do mês (1 - 5), em que a semana 1 começa no primeiro dia do mês e termina no sétimo, a semana 2 começa no oitavo dia e termina no décimo quarto dia. Por exemplo, Fev 1 designa a primeira semana de fevereiro.
WW
Semana do ano (01 - 53), em que a semana 01 começa em 1º de janeiro e termina em 7 de janeiro, a semana 2 começa em 8 de janeiro e termina em 14 de janeiro e assim por diante.
- / . ; :
Pontuação exibida na saída. Você pode usar esses símbolos para separar partes da data. Por exemplo, crie a seguinte expressão para separar partes da data com um ponto final: TO_CHAR( DATES, ‘MM.DD.YYYY’ ).
“text”
Texto exibido na saída. Por exemplo, se você criar uma porta de saída com a expressão: TO_CHAR( DATES, ‘MM/DD/YYYY “Sales Were Up”’ ) e passar a data 1º de abril de 1997, a função retornará a string ‘04/01/1997 Sales Were Up’. Você pode inserir caracteres multibyte que sejam válidos na página de código de repositório.
“”
Use aspas duplas para separar strings de formato ambíguas, por exemplo D“”DDD. As aspas vazias não aparecem na saída.
A string de formato não faz distinção entre maiúsculas e minúsculas. Ela deve estar sempre entre aspas simples.