Função Formatar Cadeia de Data

A função Formatar Sequência de Caracteres de Data converte o tipo de dado de Esquema XML: xs:dateTime em uma sequência no formato definido pelo segundo parâmetro.

Parâmetro: dateTime

A data e hora como um tipo de dado de Esquema XML: xs:dateTime.

Parâmetro: cadeia

Esta cadeia define o formato da cadeia de data e hora retornada desta função. Por exemplo, a cadeia de formatações pode ser igual a MM/dd/aaaa. Para obter informações adicionais sobre as sequências padrão de data e hora suportadas, consulte a classe SimpleDataFormat no Javadoc Sun J2SE 1.4.2: http://www.science.uva.nl/ict/ossdocs/java/jdk1.3/docs/api/java/text/SimpleDateFormat.html.
Letra Padrão Descrição Exemplo1 Exemplo2
G Designação de época AD BC
y Ano 2004 2001
M Mês em um ano Abril 04
w Semana em um ano 12 24
W Semana em um mês 3 1
D Dia em um ano 234 333
d Dia em um mês 13 20
F Dia da semana em um mês 1 3
E Dia em uma semana Segunda-feira Sexta-feira
a Designação AM ou PM AM PM
H Hora em um dia - um número entre 0 e 23 12 13
k Hora em um dia - um número entre 1 e 24 14 23
K Hora em AM ou PM - um número entre 0 e 11 0 10
h Hora em AM ou PM - um número entre 1 e 12 11 12
m Minuto em uma hora 20 50
s Segundo em um minuto 10 30
S Milissegundos 224 338
z Fuso horário na designação de fuso horário Geral PDT EDT
Z Fuso horário na designação de fuso horário RFC 822 -0300 +0200
Parâmetro: cadeia  (Opcional)

Esta cadeia define o código do idioma. Por exemplo, o código do idioma Inglês dos Estados Unidos é definido com a seguinte cadeia: en_US.

A cadeia de código do idioma pode ser definida por qualquer um dos seguintes formatos:

  • LANGUAGE
  • LANGUAGE_COUNTRY
  • LANGUAGE_COUNTRY_VARIANT
Em que LANGUAGE representa um código de duas letras, conforme definido pelo padrão ISO-639, COUNTRY representa um código de duas letras definido pelo ISO-3166 e VARIANT representa um código do fornecedor ou específico do navegador, por exemplo WIN para Windows.

Este parâmetro é opcional.

Para incluir este parâmetro:
  1. Arraste a função Formatar Cadeia de Data para a área de janela central do Editor de Mapeamento.
  2. Clique duas vezes na função. A área de janela Propriedades da Função é aberta.
  3. Clique em Incluir. O parâmetro de entrada Código do Idioma é mostrado na lista de parâmetros.

Retorna: cadeia

A data e hora passada como um cadeia no formato definido pelo segundo parâmetro.

Por exemplo, se a função Formatar Sequência de Caracteres de Data foi chamada com os parâmetros de entrada a seguir:

dateTime: 2005-02-22T16:18:00.852-08:00

cadeia de formatações: MM/dd/aaaa

cadeia de código do idioma: en_US

A seguinte cadeia seria retornada: 02/22/2005.