IBM FileNet P8, Version 5.2.1            

Máscaras de Data/Hora

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.

Componentes

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.

Tabela 1. Tabela de Componentes da Máscara de Data/Hora
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.

Separadores

Os símbolos a seguir são separadores válidos. A utilização de separadores é opcional.

Tabela 2. Tabela de Símbolos Separadores Válidos
Símbolo separador Símbolo separador Símbolo separador
, . /
- < >
? : |
^ ; "
[ ] {
} _ =
@ % +
( ) *
& # <espaço>

Amostras

Em todos os exemplos, o tempo é equivalente à:
  • Quarta-feira, 8 de Junho, 2000 às 14h05min32s
Tabela 3. Tabela de Máscaras de Data/Hora e Resultados para o Exemplo
Máscara Resultados
"mon. dd, yyyy"
Jun 8, 2000
"month dd, yyyy"
Junho 8, 2000
"mon dd, yy (day)"
Jun 8, 00 (Qua)
''hhttss"
140532
"hh:tt am"
02:05 pm
"dd-mm-yy, hh:tt"
8-6-00, 14:05
"mm/dd/yyyy, hh:tt:ss am"
6/8/2000, 02:05:032 pm
"ddd, hh:tt:ss"
167, 14:05:32
"tt:ss am"
05:32 pm
"xs:datetime"
2000-06-08T14:05:32


Last updated: October 2015
bpfe019.htm

© Copyright IBM Corporation 2015.