Date

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 SimpleDateFormat, ou "user" ou empty ("user").

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 TimeZone.getTimeZone() ou fuso horário do servidor. Por exemplo, no caso de TimeZone.getTimeZone(), para especificar a costa leste, informe: "America/New_York".

Ao usar a variável TimeZoneID, coloque o parâmetro format entre aspas. Isso vale apenas quando TimeZoneId for indicado. Não é necessário atualizar os relatórios anteriores ao aprimoramento de TimeZoneId .

Tabela -14 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

<<Date("d/M/yy")>>

23/3/02

<<Date("d-MMM-yy")>>

23-Mar-02

<<Date("EEEE, MMMM dd, yyyy")>>

Terça-feira, março 23, 2002

<<Date("h:mm:ss a")>>

12:52:05 PM

<<Date("h:mm:ss a zzzz")>>

12:52:05 PM Horário Padrão do Leste

<<Date("EEEE, MMMM dd, yyyy G 'time:' h:mm:ss a zzzz")>>

Terça-feira, 23 de março de 2002 hora AD: 12:52:05 PM Horário Padrão do Leste

<<Date("hh 'o’’clock' a, zzzz")>>

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.