Tópico anterior: Valores mantidos na versão inicial de um objeto copiadoPróximo tópico: Usando máscaras para especificar padrões nas sequências de caracteres


Formatar especificadores para datas

O CA Process Automation usa a sequência de caracteres padrão de formato de data e hora do Java padrão. Na sequência de caracteres padrão de data e hora, letras entre aspas de 'A' a 'Z' e de 'a' a 'z' são interpretadas como letras padrões que representam os componentes de uma sequência de caracteres de data ou hora. O texto pode ser colocado entre aspas usando aspas simples (') ou aspas duplas (") para evitar a interpretação. "''" representa uma aspa simples. Todos os outros caracteres não são interpretados; eles são copiados para a sequência de caracteres de saída durante a formatação ou comparadas contra a sequência de caracteres de entrada durante a análise.

Letra

Componente de data ou hora

Apresentação

Exemplos

I

Designador era

Texto

AD

a

Ano

Ano

2009; 09

m

Mês do ano

Mês

Julho; 07

w

Semana do ano

Número

27

W

Semana do mês

Número

2

D

Dia do ano

Número

189

d

Dia do mês

Número

10

F

Dia da semana do mês

Número

2

E

Dia da semana

Texto

Terça-feira; ter

a

Marcador AM/PM

Texto

PM

h

Hora do dia (0-23)

Número

0

k

Hora do dia (1-24)

Número

24

K

Hora em AM/PM (0-11)

Número

0

h

Hora em AM/PM (1-12)

Número

12

M

Minuto da hora

Número

30

s

Segundo do minuto

Número

55

s

Milissegundo

Número

978

z

Fuso horário

Fuso horário geral

Hora Padrão do Pacífico; PST; GMT-08:00

Z

Fuso horário

Fuso horário RFC 822

-0800

Padrões geralmente são repetidos; seu número determina a apresentação exata como mostrado na tabela a seguir:

Apresentação

Formatação

Texto

Se a quantidade de caracteres padrões é 4 ou mais, todo o formulário é usado; caso contrário, uma forma curta ou abreviada é aceita, independente do número de caracteres padrões.

Número

A quantidade de caracteres padrão é o número mínimo de dígitos e números menores são analisados em zero para esse valor. Durante a análise o número de caracteres padrões é ignorado, a menos que seja necessário para separar dois campos adjacentes.

Ano

Se a quantidade de letras padrões é 2, o ano é truncado para 2 dígitos; caso contrário, ele é interpretado como um número.

Durante a análise, se o número de caracteres padrões é maior do que 2, o ano é interpretado literalmente, independentemente do número de dígitos. Usando o padrão "mm/dd/aaaa", "01/11/12" analisa para 11 de janeiro de 2012 D.C.

Mês

Se a quantidade de caracteres padrões é 3 ou mais, o mês é interpretado como texto; caso contrário, é interpretado como um número.

Fuso horário geral

Os fusos horários são interpretados como texto se eles têm nomes. Para fusos horários que representam um valor de desvio do GMT, a sintaxe a seguir será usada:

  • GMTOffsetTimeZone:
  • Horas do símbolo de GMT: minutos
  • O sinal é + ou -
  • As horas devem ser um valor entre 0 e 23 e um dos seguintes formatos:

Dígito

Dígito Dígito

  • Os minutos devem estar entre 00 e 59 e no seguinte formato:

Dígito Dígito

  • Dígito é um dos seguintes:

0 1 2 3 4 5 6 7 8 9

O formato é independente do local e deve ser assumido do bloco de latim básico do Unicode padrão.

Fuso horário RFC 822

Um formato de fuso horário de quatro dígitos é usado:

  • RFC822TimeZone:

Sing TwoDigitHours Minutes

  • TwoDigitHours deve estar entre 00 e 23. As outras definições são como fusos horários gerais.

SimpleDateFormat também oferece suporte a sequências de caracteres padrões de data e hora localizada. Nessas sequências de caracteres, os caracteres padrões descritos acima podem ser substituídos por outro, dependendo do local e caracteres padrão. SimpleDateFormat não lida com a localização do texto além dos caracteres padrões; que é até o cliente da classe.

Os exemplos a seguir mostram como os padrões de data e hora são interpretados nos inglês dos estados unidos local. A data e a hora específicas são 2009-07-04 12:08:56 no fuso horário do Pacífico dos Estados Unidos.

Padrão de data e hora

Resultado

"aaaa.MM.dd G 'at' HH:mm:ss z"

2009.07.04 AD às 12:08:56 PDT

"EEE, MMM d, aa"

Qua, 4 de jul de 09

"h:mm a"

12:08 PM

"hh 'o''clock' a, zzzz"

12 horas, horário de verão do Pacífico

"K:mm a, z"

0:08 PM, PDT

"aaaa.MMMMM.dd GGG hh:mm aaa"

02009.Julho.04 AD 12:08 PM

"EEE, d MMM aaaa HH:mm:ss Z"

Qua, 4 Jul 2009 12:08:56 -0700

"aaMMddHHmmssZ"

010704120856-0700

"aaaa-MM-dd'T'HH:mm:ss.SSSZ"

2009-07-04T12:08:56.235-0700