Date
é uma função de texto que retorna a data e a hora em que um formulário on-line é preenchido com dados, ou a data e a hora em que um relatório de instantâneos é salvo. A data e a hora são recuperadas no servidor de relatórios e correspondem ao país em que o servidor está localizado. Você pode usar Date
em uma caixa de texto, uma célula de texto ou um cabeçalho de linha ou coluna.
Nota:
O formato de data e hora varia por configuração regional. Os exemplos neste tópico são para os Estados Unidos.Sintaxe:
<<Date("format,TimeZoneId")>>
Argumento | Descrição |
---|---|
format |
Assume como padrão a preferência do usuário para a data/hora. Os valores válidos são aqueles aceitos pelo Java Os caracteres do formato de data e hora fazem distinção entre maiúsculas e minúsculas. |
TimeZoneId |
Os valores válidos são aqueles aceitos pelo Java Ao usar a variável TimeZoneID, coloque o parâmetro |
Tabela 11-8 Caracteres do Formato de Data e Hora
Caracteres do Formato | Significado | Tipo de Dados | Exemplo |
---|---|---|---|
G |
designador da era |
texto |
AD |
M |
mês do ano |
texto ou número |
Se o mês for julho: M exibe: 7 MM exibe: 07 MMM exibe: Jul MMMM exibe: julho |
d |
dia do mês |
número |
10 |
h |
hora em formato de 12 horas (am/pm) |
número |
11 |
H |
hora no dia (0-23) |
número |
22 |
m |
minuto na hora |
número |
30 |
s |
segundo no minuto |
número |
25 |
S |
milissegundo |
número |
978 |
E |
dia da semana |
texto |
E: Ter EE: Terça-feira |
D |
dia do ano |
número |
189 |
F |
dia da semana no mês |
número |
<<Date("dd-MMM-yy ‘é o (a)’ F 'º/ª ' E 'de' ‘MMM")>> exibe: 24-Dez-02 é o (a) 4º/ª Ter de Dez |
w |
semana do ano |
número |
27 |
W |
semana do mês |
número |
2 |
a |
marcador de am/pm |
texto |
PM |
k |
hora do dia (1-24) |
número |
23 |
K |
hora em formato de 12 horas (0-11, am/pm) |
número |
Se a hora for 3:37PM: 3 |
z |
fuso horário |
texto |
Hora Padrão do Pacífico |
y |
ano |
número |
2002,02 |
' |
texto literal |
texto |
<<Date(" D’o dia de ’yyyy")>> exibe:105º dia de 2002 |
' ' |
duas aspas simples para produzir uma aspa simples |
texto |
<<Date("k:mm ‘O’’Clock’ a")>> exibe: 6:15 O’Clock PM Nota: Use duas aspas simples para produzir uma aspa simples ou um apóstrofo, como em O’Clock (O’’Clock). |
Considerações ao usar caracteres de format:
O número ou contagem dos caracteres de format determina o formato:
Para texto, menos de quatro letras do padrão significa forma curta ou abreviada, se houver.
Quatro ou mais letras de padrão significam forma completa.
M ou MM significa usar o mês como número.
MMM significa usar a abreviação de três letras desse mês.
MMMM significa o uso do nome completo do mês.
Por exemplo, se a data for 24 de abril:
<<Date("dd-M-yy")>> displays 24-4-02
<<Date("dd-MM-yy)>> exibe 24-04-02
<<Date("dd-MMM-yy")>> displays 24-Apr-02
<<Date("dd-MMMM-yy")>> displays 24-April-02
Para números, o número de letras do padrão é o número mínimo de dígitos. Números mais curtos são preenchidos com zeros. Ano é um caso especial. Se você usar "yy", os dois últimos dígitos do ano são exibidos, mas se usar "yyyy", o ano com quatro dígitos será exibido.
Por exemplo, se o mês for fevereiro:
<<Date("MM-yyyy")>> displays 02-2002
Todos os caracteres do alfabeto em maiúsculas e minúsculas são considerados padrões, sem importar se são caracteres de format designados.
Coloque texto literal entre aspas simples. Para usar aspas simples em texto literal, é preciso delimitar o texto entre aspas simples e usar duas aspas simples para o apóstrofo.
Por exemplo, o formato para imprimir 4 o'clock é:
<<Date("hh 'o''clock' ")>>
Exemplos:
Formato de Data | Resultado |
---|---|
|
23/3/02 |
|
23-Mar-02 |
|
Terça-feira, março 23, 2002 |
|
12:52:05 PM |
|
12:52:05 PM Horário Padrão do Leste |
|
Terça-feira, 23 de março de 2002 hora AD: 12:52:05 PM Horário Padrão do Leste |
|
12:00 PM, Horário Padrão do Leste Nota: Você precisa usar duas aspas simples para produzir uma aspa simples no texto de seu resultado formatado. |