DateTime
é uma função de texto que retorna a data e a hora em que um relatório é preenchido com dados. A data e a hora são recuperadas do servidor de relatórios e correspondem ao país em que o servidor de relatórios está localizado. Você pode usar DateTime
em uma caixa de texto, em uma célula de texto ou em um cabeçalho de linha ou de coluna.
Nota:
O fuso horário usado nos resultados da função de texto em visualizações de relatórios é baseado no fuso horário de cada usuário especificado em Preferências do Usuário.
Sintaxe:
DateTime("DateFormat","TimeFormat")
Nota:
Se os parâmetros da função DateTime forem deixados em branco, por exemplo, DateTime ()
, ou se "none" for usado nos dois parâmetros, por exemplo, DateTime (none, none)
, as Preferências do Usuário do Narrative Reporting para Data e Hora serão usadas como formato.
Nota:
Consulte Parâmetros para Funções de Texto para obter as definições de parâmetro.
Se preferir, você pode especificar valores de localidade neutra para formatos curtos, médios, longos e completos: DateTime (short|medium|long|full|none, short|medium|long|full|none)
. (Não use aspas ao informar esses valores.) Exemplos (exemplos dados para os Estados Unidos):
DateTime(short, short)
: 01/03/2017 1:54 PM
DateTime(medium, medium)
: Jan 03, 2017 1:54:32 PM
DateTime(long, long)
: Janeiro 03, 2017 1:54:32 PM PDT
DateTime(full, none)
: Terça-feira, Janeiro 03, 2017 (Nota: a hora não é mostrada.)
DateTime(none, short)
: 1:54 PM (Nota: a data não é mostrada.)
Tabela 10-9 Caracteres de Formato de Data e Hora
Caracteres de Formato | Significado | Tipo de Dados | Exemplo |
---|---|---|---|
G |
designador de era |
texto |
AD |
M |
mês do ano |
texto ou número |
Se o mês for julho: M aparece como: 7 MM aparece como: 07 MMM aparece como: Jul MMMM aparece como: Julho |
d |
dia do mês |
número |
10 |
h |
hora em am/pm (1-12) |
número |
11 |
H |
hora do dia (0-23) |
número |
22 |
m |
minuto da hora |
número |
30 |
s |
segundo do 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-aa ‘é o’ F 'º ' E 'de' ‘MMM") aparece como: 24-Dez-02 é a 4ª Ter de Dez |
w |
semana do ano |
número |
27 |
W |
semana do mês |
número |
2 |
a |
marcador am/pm |
texto |
PM |
k |
hora do dia (1-24) |
número |
23 |
K |
hora em am/pm (0-11) |
número |
Nos Estados Unidos, a hora é 3:37 PM: 3 |
z |
fuso horário |
texto |
Horário Padrão do Pacífico |
y |
ano |
número |
2017,02 |
' |
texto literal |
texto |
Date(" D’ dia de ’aaaa") aparece como: 105º dia de 2017 |
' ' |
duas aspas simples para produzir uma única aspa |
texto |
Date("k:mm ‘O’’Clock’ a") aparece como: 6:15 O’Clock PM Use 2 aspas simples para produzir uma única aspa ou um apóstrofo como em O’Clock (O’’Clock). |
Considerações ao usar caracteres de formato:
O número ou a contagem de caracteres de formato determina o formato:
Para o texto, menos de quatro letras padrão significa usar um formulário curto ou abreviado, se existir.
Quatro ou mais letras padrão significa usar o formulário completo.
M ou MM significa usar o mês como um número.
MMM significa usar a abreviatura de três letras para o mês.
MMMM significa usar o nome completo do mês.
Por exemplo, se a data for 24 de abril:
Date("dd-M-yy")
exibe 24-4-17
Date("dd-MM-yy")
exibe 24-04-17
Date("dd-MMM-yy")
exibe 24-Abr-17
Date("dd-MMMM-yy")
exibe 24-Abril-17
Para números, o número de letras padrão é o número mínimo de dígitos. Os números mais curtos são preenchidos com zeros. Ano é um caso especial. Se você usar "aa", os dois últimos dígitos do ano serão exibidos, mas, se você usar "aaaa", o ano de quatro dígitos será exibido.
Por exemplo, se o mês for fevereiro:
Date("MM-yyyy")
exibe 02-2017
Todos os caracteres de letras maiúsculas e minúsculas são considerados padrões, independentemente de serem designados caracteres de formato.
Coloque o texto literal entre aspas simples. Para usar uma aspa simples no texto literal, coloque o texto entre aspas simples e use duas aspas simples para o apóstrofo.
Por exemplo, o formato para imprimir 4 horas é:
Date("hh 'o''clock' ")
Exemplos:
Formato de Data | Resultado |
---|---|
|
23/3/17 |
|
23-Mar-17 |
|
Terça-feira, março 23, 2017 |
|
12:52:05 PM |
|
12:52:05 PM Horário Padrão do Leste |
|
Terça-feira, março 23, 2017 2017 AD hora: 12:52:05 PM Horário Padrão do Leste |
|
12:00 PM, Horário Padrão do Leste Você deve usar duas aspas simples para produzir uma aspa simples no texto do resultado formatado. |