Date

La funzione testo Date restituisce la data e l'ora in cui un report online è stato popolato con dati oppure la data e l'ora in cui un report snapshot è stato salvato. La data e l'ora vengono recuperati dal server di reporting e fanno riferimento al paese in cui si trova tale server. È possibile utilizzare la funzione Date in una casella di testo, una cella di testo oppure in un'intestazione di riga o colonna.

Nota:

Il formato di data e ora varia in base alle impostazioni nazionali. Gli esempi descritti in questo argomento sono esempi validi per gli Stati Uniti.

Sintassi

<<Date("format,TimeZoneId")>>

Argomento Descrizione

Argomento	Descrizione
formato	Utilizza come valore predefinito le preferenze utente per data/ora. I valori validi sono quelli accettati da `SimpleDateFormat` Java, ovvero "user" o vuoto ("user"). I caratteri di formattazione (formato) della data e dell'ora considerano l'esatta combinazione di maiuscole e minuscole.
IdFusoOrario	I valori validi sono quelli accettati da `TimeZone.getTimeZone()` Java, ovvero il fuso orario del server. Ad esempio, nel caso di `TimeZone.getTimeZone()` per specificare la costa orientale degli Stati Uniti, immettere "America/New_York". Quando si utilizza IdFusoOrario, è necessario racchiudere il parametro `formato` tra virgolette. Questa condizione si applica solo quando viene specificato IdFusoOrario. Non è necessario aggiornare i report prima dell'ottimizzazione di IdFusoOrario.

formato

Utilizza come valore predefinito le preferenze utente per data/ora. I valori validi sono quelli accettati da SimpleDateFormat Java, ovvero "user" o vuoto ("user").

I caratteri di formattazione (formato) della data e dell'ora considerano l'esatta combinazione di maiuscole e minuscole.

IdFusoOrario

I valori validi sono quelli accettati da TimeZone.getTimeZone() Java, ovvero il fuso orario del server. Ad esempio, nel caso di TimeZone.getTimeZone() per specificare la costa orientale degli Stati Uniti, immettere "America/New_York".

Quando si utilizza IdFusoOrario, è necessario racchiudere il parametro formato tra virgolette. Questa condizione si applica solo quando viene specificato IdFusoOrario. Non è necessario aggiornare i report prima dell'ottimizzazione di IdFusoOrario.

Tabella 11-8 Caratteri di formattazione della data e dell'ora

Caratteri di formattazione	Descrizione	Tipo di dati	Esempio
G	Identificatore dell'era	testo	AD
M	Mese dell'anno	testo o numero	Se il mese è luglio: M visualizza: 7 MM visualizza: 07 MMM visualizza: Lug MMMM visualizza: Luglio
d	Giorno del mese	numero	10
h	Ora nel formato 12 ore (AM/PM)	numero	11
H	Ore del giorno (0-23)	numero	22
m	Minuti in un'ora	numero	30
s	Secondi in un minuto	numero	25
S	Millisecondi	numero	978
E	Giorno della settimana	testo	E: Mar EE: Martedì
D	Giorno dell'anno	numero	189
F	Giorno della settimana nel mese	numero	<<Date("dd-MMM-yy 'è il' F '° ' E 'di' 'MMM')>> visualizza: 24-Dic-02 è il 4° Mar di Dic
w	Settimana dell'anno	numero	27
W	Settimana del mese	numero	2
a	Indicatore AM/PM	testo	PM
k	Ora del giorno (1-24)	numero	23
K	Ora nel formato 12 ore (AM/PM)	numero	Se l'ora è 3:37PM: 3
z	Fuso orario	testo	Ora solare Pacifico
y	Anno	numero	2002,02
'	Testo letterale	testo	<<Date(" D'° giorno del 'yyyy")>> visualizza: 105° giorno del 2002
' '	Due virgolette singole per creare una virgoletta	testo	<<Date("k:mm 'o''clock' a")>> visualizza: 6:15 o'clock PM Nota: Utilizzare due virgolette singole per creare una virgoletta o un apostrofo come nell'esempio "o'clock" (o''clock).

Considerazione sull'utilizzo dei caratteri di formattazione (formato):

Il numero dei caratteri di formattazione (formato) determinano il formato:
- Per i valori testuali, meno di quattro lettere pattern indicano l'utilizzo della forma abbreviata, se esistente.
- Quattro o più lettere pattern indicano l'utilizzo della forma completa.
- M o MM indica l'utilizzo del mese sotto forma numero.
- MMM indica l'utilizzo dell'abbreviazione di tre caratteri del mese.
- MMMM indica l'utilizzo del nome completo del mese.
Ad esempio, se la data è 24 aprile:

<<Date("dd-M-yy")>> visualizza 24-4-02

<<Date("dd-MM-yy")>> visualizza 24-04-02

<<Date("dd-MMM-yy")>> visualizza 24-Apr-02

<<Date("dd-MMMM-yy")>> visualizza 24-Aprile-02
Per i valori numerici, i numeri di lettere pattern indicano il numero minimo di cifre. Ai numeri più corti vengono aggiunti zero. L'anno è un caso speciale. Se si utilizza "yy", vengono visualizzate le ultime due cifre dell'anno; se invece si utilizza "yyyy", verrà visualizzato l'anno nel formato a quattro cifre.

Ad esempio, se il mese è Febbraio:

<<Date("MM-yyyy")>> visualizza 02-2002
Tutti i caratteri alfabetici maiuscoli e minuscoli vengono considerati caratteri pattern, indipendentemente dal fatto che si tratti effettivamente di caratteri di formattazione (formato).
Racchiudere il testo del valore tra virgolette. Per utilizzare una virgoletta singola all'interno del testo, racchiudere il testo all'interno di virgolette singole e utilizzare due virgolette singole per indicare l'apostrofo.

Ad esempio, il formato da utilizzare per stampare "4 o'clock" è:

<<Date("hh 'o''clock' ")>>

Esempi

Formato data	Risultato
`<<Date("d/M/yy")>>`	23/3/02
`<<Date("d-MMM-yy")>>`	23-Mar-02
`<<Date("EEEE, MMMM dd, yyyy")>>`	Martedì, Marzo 23, 2002
`<<Date("h:mm:ss a")>>`	12:52:05 PM
`<<Date("h:mm:ss a zzzz")>>`	12:52:05 PM Ora solare fuso orientale
`<<Date("EEEE, MMMM dd, yyyy G 'ora:' h:mm:ss a zzzz")>>`	Martedì, Marzo 23, 2002 AD ora: 12:52:05 PM Ora solare fuso orientale
`<<Date("hh 'o''clock' a, zzzz")>>`	12:00 PM Ora solare fuso orientale Nota: È necessario utilizzare due virgolette singole per creare una virgoletta nel testo del risultato formattato.