DateTime

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.

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 11-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
`Date("d/M/yy")`	23/3/17
`Date("d-MMM-yy")`	23-Mar-17
`Date("EEEE, MMMM dd, yyyy")`	Terça-feira, março 23, 2017
`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, março 23, 2017 2017 AD hora: 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 Você deve usar duas aspas simples para produzir uma aspa simples no texto do resultado formatado.