DateTime è una funzione testo che restituisce la data e l'ora dell'inserimento dei dati in un report. La data e l'ora vengono recuperate dal server dei report e corrispondono al fuso orario del paese in cui si trova il server dei report. La funzione DateTime può essere utilizzata nell'intestazione di una casella o di una cella di testo, di una riga o di una colonna.
Nota:
Il fuso orario utilizzato nei risultati della funzione testo nell'anteprima del report si basa sul fuso orario di ciascun utente specificato in Preferenze utente.
Sintassi:
DateTime("DateFormat","TimeFormat")
Nota:
Se i parametri della funzione DateTime non vengono specificati, ad esempio DateTime (), oppure se si utilizza "none" in entrambi i parametri, ad esempio DateTime (none, none), per il formato verranno utilizzate le preferenze utente di Narrative Reporting relative alla data e all'ora.
Nota:
Per le definizioni dei parametri, vedere Parametri per le funzioni testo.
In alternativa, è possibile specificare valori neutri rispetto alle impostazioni nazionali per i formati breve, medio, lungo e completo: DateTime (short|medium|long|full|none, short|medium|long|full|none). (Non utilizzare le virgolette durante l'immissione di questi valori). Esempi (per gli Stati Uniti):
DateTime(short, short): 01/03/2017 1:54 PM
DateTime(medium, medium): Jan 03, 2017 1:54:32 PM
DateTime(long, long): January 03, 2017 1:54:32 PM PDT
DateTime(full, none): Tuesday, January 03, 2017 (Nota: l'ora non viene mostrata).
DateTime(none, short): 1:54 PM (Nota: la data non viene mostrata).
Tabella 10-9 Caratteri di formato della data e dell'ora
| Caratteri formato | Significato | 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 in AM/PM (1-12) |
numero |
11 |
|
H |
Ora del giorno (0-23) |
numero |
22 |
|
m |
Minuto dell'ora |
numero |
30 |
|
s |
Secondo del minuto |
numero |
25 |
|
S |
Millisecondo |
numero |
978 |
|
E |
Giorno della settimana |
testo |
E: Mar EE: Martedì |
|
D |
Giorno dell'anno |
numero |
189 |
|
F |
Giorno della settimana del 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 in AM/PM (0-11) |
numero |
Negli Stati Uniti, se l'ora è 3:37 PM: 3 |
|
z |
Fuso orario |
testo |
Ora standard Pacifico |
|
y |
Anno |
numero |
2017,02 |
|
' |
Testo letterale |
testo |
Date(" D'° giorno del 'yyyy") visualizza: 105° giorno del 2017 |
|
' ' |
Due apici per produrre un singolo apice |
testo |
Date("k:mm 'O''Clock' a") visualizza: 6:15 O'Clock PM Utilizzare 2 apici per produrre un solo apice o un apostrofo come in O'Clock (O''Clock). |
Considerazioni sull'utilizzo dei caratteri di formato
Il numero o il conteggio dei caratteri di formato determina il formato, come riportato di seguito.
Per il testo, un numero di lettere dello schema inferiore a quattro indica l'uso di una forma breve o abbreviata, se esistente.
Un numero di lettere dello schema uguale o superiore a quattro indica l'uso della forma completa.
M o MM indica l'uso del mese sotto forma di numero.
MMM indica l'uso di un'abbreviazione di tre lettere per il mese.
MMMM indica l'uso del nome completo del mese.
Ad esempio, se la data è il 24 aprile:
Date("dd-M-yy") visualizza 24-4-17
Date("dd-MM-yy") visualizza 24-04-17
Date("dd-MMM-yy") visualizza 24-Apr-17
Date("dd-MMMM-yy") visualizza 24-Aprile-17
Per i numeri, il numero delle lettere dello schema è il numero minimo delle cifre. Per i numeri più brevi vengono aggiunti degli zeri. L'anno costituisce un caso speciale. Se si utilizza "yy", vengono visualizzate le ultime due cifre dell'anno, mentre se si utilizza "yyyy", viene visualizzato l'anno con tutte e quattro le cifre.
Ad esempio, se il mese è Febbraio:
Date("MM-yyyy") visualizza 02-2017
Tutti i caratteri alfabetici maiuscoli e minuscoli vengono considerati caratteri di schema, indipendentemente dal fatto che siano caratteri di formato designati.
Racchiudere il testo letterale tra apici. Per utilizzare un apice nel testo letterale, racchiudere il testo tra apici e utilizzare due apici per l'apostrofo.
Ad esempio, il formato per ottenere 4 o'clock è:
Date("hh 'o''clock' ")
Esempi
| Formato data | Risultato |
|---|---|
|
|
23/3/17 |
|
|
23-Mar-17 |
|
|
Tuesday, March 23, 2017 (Martedì, Marzo 23, 2017) |
|
|
12:52:05 PM |
|
|
12:52:05 PM Eastern Standard Time (Ora standard fuso orientale) |
|
|
Tuesday, March 23, 2017 AD time: 12:52:05 PM Eastern Standard Time (Martedì, Marzo 23, 2017 AD ora: 12:52:05 PM Ora standard fuso orientale) |
|
|
12:00 PM, Ora standard fuso orientale Per ottenere un solo apice nel testo del risultato formattato, è necessario utilizzare due apici. |