|
Assistência ao utilizador para autores de conteúdo |
|---|
Definir os parâmetros de formatação de datas
Estes parâmetros são utilizados para definir o formato de datas.
| Símbolo | Significado | Apresentação | Exemplo |
|---|---|---|---|
| G | designador de era | (Texto) | DC |
| y | ano | (Número) | 1996 |
| M | mês do ano | (Texto e Número) | Julho e 07 |
| d | dia do mês | (Número) | 10 |
| h | hora em formato de 12 horas (1-12) | (Número) | 12 |
| H | hora em formato de 24 horas (0-23) | (Número) | 0 |
| m | minutos da hora | (Número) | 30 |
| s | segundos do minuto | (Número) | 55 |
| S | milissegundo | (Número) | 978 |
| E | dia da semana | (Texto) | terça-feira |
| D | dia do ano | (Número) | 189 |
| F | dia da semana no mês | (Número) | 2 (2ª quarta-feira de Julho) |
| w | semana do ano | (Número) | 27 |
| W | semana do mês | (Número) | 2 |
| a | marcador de 12 horas | (Texto) | PM |
| k | hora em formato de 24 horas (1-24) | (Número) | 24 |
| K | hora em formato de 12 horas (0-11) | (Número) | 0 |
| z | fuso horário | (Texto) | Hora padrão do Pacífico |
| ' | mudança de código para texto | (Delimitador) | |
| '' | plicas | (Literal) |
O número de letras determina o formato:
- Texto
- Quatro ou mais letras padrão, utilize a forma completa
- Menos de quatro, utilize a abreviatura, caso exista
- Exemplo: Dia/Mês/Ano
- d,M,a = 3,3,3.
- dd,MM,aa = 03,03,03.
- dd,MMM,aa = 03,Mar,03.
- dd,MMMM,aaaa = 03,Março,2003.
Minúsculas e maiúsculas:
- A utilização de maiúsculas e minúsculas no código de data e hora não é homogénea. Por exemplo, "M" para mês mas "d" para dia e "a" para ano.
- As letras em maiúsculas e minúsculas podem ter significados diferentes. Por exemplo, "s" para segundos e "S" para milissegundo.
Formato incorrecto:
Se uma data ou hora for introduzida de forma incorrecta, não são devolvidos quaisquer dados.
Outros caracteres:
Todos os caracteres do padrão que não pertençam aos intervalos de ['a'..'z'] e ['A'..'Z'] são tratados como texto entre aspas. Por exemplo, caracteres como ':', '.', ' ', '#' e '@' serão apresentados no texto de hora resultante, ainda que não tenham sido colocados entre plicas.
Exemplos utilizando a definição de configuração regional US
| Padrão de Formato | Resultado |
|---|---|
| "yyyy.MM.dd G 'at' hh:mm:ss z" | 1996.07.10 AD at 15:08:56 PDT |
| "EEE, MMM d, ''yy" | Wed, July 10, '96 |
| "h:mm a" | 12:08 PM |
| "hh 'o''clock' a, zzzz" | 12 o'clock PM, Pacific Standard Time |
| "K:mm a, z" | 0:00 PM, PST |
| "yyyyy.MMMMM.dd GGG hh:mm aaa" | 1996.July.10 AD 12:08 PM |