Questa variabile di ambiente definisce il formato della data utilizzato come predefinito nell'app e per data che restituisce funzioni come date() e date#(). Il formato viene utilizzato per interpretare e formattare le date. Se la variabile non è definita, il formato della data delle impostazioni regionali sarà recuperato quando viene eseguito lo script.
Sintassi:
DateFormat
Esempi di funzioni DateFormat
Esempio
Risultato
Set DateFormat='M/D/YY'; //(US format)
Quando viene utilizzata in questo modo, la funzione DateFormat definisce la data con il formato USA, mese/giorno/anno.
Set DateFormat='DD/MM/YY'; //(UK date format)
Quando viene utilizzata in questo modo, la funzione DateFormat definisce la data con il formato GB, giorno/mese/anno.
Set DateFormat='YYYY/MM/DD'; //(ISO date format)
Quando viene utilizzata in questo modo, la funzione DateFormat definisce la data con il formato ISO, anno/mese/giorno.
Impostazioni locali
Se non diversamente specificato, gli esempi di questo argomento utilizzano il seguente formato di data: MM/GG/AAAA. Il formato della data viene specificato nell'istruzione SET DateFormat nello script di caricamento dei dati. La formattazione predefinita della data potrebbe essere diversa nel proprio sistema, a causa delle impostazioni regionali e di altri fattori. È possibile modificare i formati degli esempi seguenti in base alle proprie esigenze. In alternativa, è possibile modificare i formati nel proprio script di caricamento per adattarli a questi esempi. Per ulteriori informazioni, vedere Modifica delle impostazioni internazionali per la creazione di app e script.
Le impostazioni regionali predefinite nelle app si basano sul profilo utente. Queste impostazioni di formato regionale non riguardano la lingua visualizzata nell'interfaccia utente Qlik Cloud. Qlik Cloud verrà visualizzato nella stessa lingua del browser utilizzato.
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Un set di dati di date.
La funzione DateFormat, che utilizzerà il formato data USA.
Nel seguente esempio, un set di dati è caricato in una tabella denominata 'Transactions'. Include un campodate. Viene utilizzata la definizione USA DateFormat. Questo modello verrà utilizzato per il testo implicito per la conversione data quando vengono caricate date di testo.
Script di caricamento
Set DateFormat='MM/DD/YYYY';
Transactions:
LOAD
date,
month(date) as month,
id,
amount
INLINE
[
date,id,amount
01/01/2022,1,1000
02/01/2022,2,2123
03/01/2022,3,4124
04/01/2022,4,2431
];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
date
month
Creare questa misura:
=sum(amount)
Tabella dei risultati
date
mese
=sum(amount)
01/01/2022
Jan
1000
02/01/2022
Feb
2123
03/01/2022
Mar
4124
04/01/2022
Apr
2431
La definizione DateFormat MM/GG/AAAA è usata per la conversione implicita del testo in date, per cui il campo date è correttamente interpretato come una data. Lo stesso formato è utilizzato per visualizzare la data, come mostrato nella tabella dei risultati.
Esempio 2 – Modifica della variabile di sistema
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Lo stesso set di dati dall'esempio precedente.
La funzione DateFormat, che utilizzerà il formato 'GG/MM/AAAA'.
Script di caricamento
SET DateFormat='DD/MM/YYYY';
Transactions:
LOAD
date,
month(date) as month,
id,
amount
INLINE
[
date,id,amount
01/01/2022,1,1000
02/01/2022,2,2123
03/01/2022,3,4124
04/01/2022,4,2431
];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
date
month
Creare questa misura:
=sum(amount)
Tabella dei risultati
date
mese
=sum(amount)
01/01/2022
Jan
1000
02/01/2022
Jan
2123
03/01/2022
Jan
4124
04/01/2022
Jan
2431
Poiché la definizione di DateFormat è stata impostata su 'GG/MM/AAAA', si può notare che le due cifre dopo il primo simbolo "/" sono state interpretate come il mese, con il risultato che tutti i record sono del mese di gennaio.
Esempio 3 – Interpretazione delle date
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Un set di dati con date in formato numerico.
La variabile DateFormat, che utilizzerà il formato ‘GG/MM/AAAA’.
La variabile date().
Script di caricamento
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
date(numerical_date),
month(date(numerical_date)) as month,
id,
amount
Inline
[
numerical_date,id,amount
43254,1,1000
43255,2,2123
43256,3,4124
43258,4,2431
];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
date
month
Creare questa misura:
=sum(amount)
Tabella dei risultati
date
mese
=sum(amount)
06/03/2022
Jun
1000
06/04/2022
Jun
2123
06/05/2022
Jun
4124
06/07/2022
Jun
2431
Nello script di caricamento, utilizzare la funzione date() per convertire la data numerica in un formato data. Dato che non si fornisce un formato specificato come argomento secondario nella funzione, viene utilizzato DateFormat. Ciò fa sì che il campo data utilizzi il formato 'MM/GG/AAAA'.
Esempio 4 – Formattazione di una data straniera
Panoramica
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Un set di dati di date.
La variabile DateFormat, che utilizza il formato 'GG/MM/AAAA' ma non presenta commenti con barre terminali.
Script di caricamento
// SET DateFormat='DD/MM/YYYY';
Transactions:
Load
date,
month(date) as month,
id,
amount
Inline
[
date,id,amount
22-05-2022,1,1000
23-05-2022,2,2123
24-05-2022,3,4124
25-05-2022,4,2431
];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
date
month
Creare questa misura:
=sum(amount)
Tabella dei risultati
date
mese
=sum(amount)
22-05-2022
-
1000
23-05-2022
-
2123
24-05-2022
-
4124
25-05-2022
-
2431
Nello script di caricamento iniziale, il DateFormat in uso è il formato predefinito ‘MM/GG/AAAA’. Poiché il campo date nel set di dati delle transazioni non è in questo formato, il campo non viene interpretato come una data. Ciò è mostrato nella tabella dei risultati in cui i valori del campo month sono NULL.
È possibile verificare i tipi di dati interpretati nel sistema di visualizzazione del modello dati verificando le proprietà "Tag" del campo date.
Questo problema può essere risolto abilitando la variabile di sistema DateFormat :
// SET DateFormat='DD/MM/YYYY';
Rimuovere le doppie barre terminali e ricaricare i dati.
Hai trovato utile questa pagina?
Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!