Uma máscara de data/hora pode ter um destes dois propósitos: Determinar o formato da saída de várias funções ou orientar a conversão de uma representação de sequência de um valor para o formato interno desse valor.
A seguir, há duas formas de uso de uma máscara de data/hora:
Uma máscara de data/hora é uma expressão de cadeia contendo qualquer combinação válida de componentes e, opcionalmente, separadores. Como a máscara de data/hora é uma cadeia, você deve colocá-la entre aspas duplas.
Para obter exemplos de uso, consulte as informações sobre as amostras de máscara de data/hora.
A seguir são apresentados os componentes permitidos em uma máscara de data/horário. Onde aplicável, o intervalo válido de cada componente é listado.
Componente | Significado |
---|---|
dd | Dia do mês com dois dígitos (de 1 a 31). |
ddd | Dia do ano com três dígitos (de 1 a 366). |
mm | Mês com um ou dois dígitos (de 1 a 12). |
mon | Abreviação de três letras do mês (de Jan a Dez). |
month | Nome completo do mês (Janeiro a Dezembro). |
yy | Ano de dois dígitos (de 00 a 99). Recomendamos fortemente a utilização do componente de quatro dígitos (yyyy) em vez do componente de dois dígitos. Com o componente de dois dígitos, internamente os dois primeiros dígitos são assumidos como sendo "20", o que pode não ser a sua intenção. Além disso, a utilização do componente de quatro dígitos identifica claramente o século e elimina qualquer problema de ambiguidade. |
yyyy | Ano de quatro dígitos (de 0000 a 9999). |
w | Dia de um dígito da semana (de 0 a 6, 0 = Domingo , 6 = Sábado). |
day | Abreviação de três letras do dia (de Sáb a Dom). |
dayname | Nome completo do dia (de Domingo a Sábado). |
hh | Hora do dia (de 0 a 23). |
tt | Minuto da hora (de 0 a 59). |
ss | Segundo do minuto (de 0 a 59). |
am | Indica o horário como am ou pm (em oposição ao relógio de 24 horas). |
xs:datetime | Indica a data e hora no formato XML conforme descrito pelo Esquema XML do W3C e da ISO 8601. O formato é: CCYY-MM-DDThh:mm:ss Todos os campos devem estar presentes e podem opcionalmente ser precedidos por um sinal e por símbolos à esquerda, se necessário, e seguidos por dígitos fracionários para os segundos e um fuso horário. O fuso horário pode ser especificado utilizando-se a letra "Z" que identifica UTC ou pela diferença de tempo em relação ao UTC. |
Os símbolos a seguir são separadores válidos. A utilização de separadores é opcional.
Símbolo separador | Símbolo separador | Símbolo separador |
---|---|---|
, | . | / |
- | < | > |
? | : | | |
^ | ; | " |
[ | ] | { |
} | _ | = |
@ | % | + |
( | ) | * |
& | # | <espaço> |
Máscara | Resultados |
---|---|
|
Jun 8, 2000 |
|
Junho 8, 2000 |
|
Jun 8, 00 (Qua) |
|
140532 |
|
02:05 pm |
|
8-6-00, 14:05 |
|
6/8/2000, 02:05:032 pm |
|
167, 14:05:32 |
|
05:32 pm |
|
2000-06-08T14:05:32 |