Função Ler Cadeia de Data
A função Ler Sequência de Caracteres de Data converte uma sequência (que contém uma data e hora) no tipo de dado de Esquema XML: xs:dateTime.
Propósito
Parâmetro: cadeia
A data e hora como uma cadeia.
Parâmetro: cadeia
Esta cadeia define o formato
da cadeia de data e hora do primeiro parâmetro. 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 SimpleDateFormat 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
Este parâmetro é opcional.
Para
incluir este parâmetro:
- Arraste a função Formatar Cadeia de Data para a área de janela central do Editor de Mapeamento.
- Clique duas vezes na função. A área de janela Propriedades da Função é aberta.
- Clique em Incluir. O parâmetro de entrada Código do Idioma é mostrado na lista de parâmetros.
Retorna: dateTime
A data e hora como um tipo de dado de Esquema XML: xs:dateTime. Por exemplo, se a função Ler Sequência de Caracteres de Data foi executada com os parâmetros de entrada a seguir:
cadeia de data e hora: 02/22/2005/12/20/44
cadeia de formatações: MM/dd/aaaa/HH/mm/ss
Um dateTime representando 22 de fevereiro de 2005 às 12:20 e 44 segundos será retornado da função Ler Cadeia de Data.