Questa funzione restituisce la data attuale. La funzione restituisce i valori nel formato della variabile di sistema DateFormat.
Sintassi:
today([ timer_mode])
Tipo di dati restituiti: duale
La funzione today() può essere utilizzata sia nello script di caricamento che negli oggetti del grafico.
Il valore predefinito timer_mode è 1.
| Argomento | Descrizione |
|---|---|
| timer_mode |
Può presentare i valori seguenti: 0 (giorno dell'ultimo caricamento di dati completato) Nota informaticaSe si utilizza la funzione in uno script di caricamento, timer_mode=0 restituirà il giorno di completamento dell'ultimo caricamento dei dati, mentre timer_mode=1 restituirà il giorno del caricamento dei dati attuale.
|
| valore timer_mode | Risultato se utilizzato nello script di caricamento | Risultato se utilizzato nell'oggetto grafico |
|---|---|---|
| 0 | Restituisce una data, nel formato della variabile di sistema DateFormat, dell'ultimo ricaricamento dei dati riuscito prima dell'ultimo ricaricamento dei dati. | Restituisce una data, nel formato della variabile di sistema DateFormat, per l'ultimo ricaricamento dei dati. |
|
1 |
Restituisce una data, nel formato della variabile di sistema DateFormat, per l'ultimo ricaricamento dei dati. | Restituisce una data, nel formato della variabile di sistema DateFormat, della chiamata alla funzione. |
|
2 |
Restituisce una data, nel formato della variabile di sistema DateFormat, per l'inizio della sessione dell'utente nell'applicazione. Non verrà aggiornato a meno che l'utente non ricarichi lo script. | Restituisce la data, nel formato della variabile di sistema DateFormat, per l'inizio della sessione dell'utente nell'applicazione. Questo valore verrà aggiornato all'inizio di una nuova sessione o quando i dati dell'applicazione verranno ricaricati. |
Casi di utilizzo
La funzione today() viene comunemente utilizzata come componente di un'espressione. Ad esempio, può essere utilizzata per calcolare gli interessi accumulati in un mese fino alla data corrente.
La tabella seguente fornisce una spiegazione del risultato restituito dalla funzione today(), in presenza di diversi valori dell'argomento timer_mode:
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.
Se si è un creatore di app, è possibile impostare la regione predefinita per le app che si creano. Per ulteriori informazioni, vedere Regolazione delle impostazioni internazionali preferite per la creazione di app e script in Qlik Cloud Analytics.
Esempio 1 – Generazione di oggetti tramite script di caricamento
Panoramica
L'esempio seguente crea tre variabili utilizzando la funzione today(). Ogni variabile utilizza una delle opzioni timer_mode per dimostrarne l'effetto.
Affinché le variabili dimostrino il loro scopo, ricaricare lo script e poi, dopo 24 ore, ricaricare lo script una seconda volta. In questo modo le variabili today(0) e today(1) mostreranno valori diversi, dimostrando così correttamente il loro scopo.
Script di caricamento
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);Risultati
Una volta che i dati vengono caricati una seconda volta, creare tre caselle di testo seguendo le indicazioni riportate di seguito.
Per prima cosa, creare una casella di testo per i dati che sono stati caricati precedentemente.
Procedere come indicato di seguito:
-
Utilizzando l'oggetto grafico Testo e immagine, creare una casella di testo.
-
Aggiungere la seguente misura all'oggetto:
=vPreviousDataLoad
-
In Aspetto, selezionare Show titles e aggiungere il titolo 'Ora di caricamento precedente' all'oggetto.
Quindi, creare una casella di testo per i dati che si stanno caricando.
Procedere come indicato di seguito:
-
Utilizzando l'oggetto grafico Testo e immagine, creare una casella di testo.
-
Aggiungere la seguente misura all'oggetto:
=vCurrentDataLoad
-
In Aspetto, selezionare Show titles e aggiungere il titolo 'Ora di caricamento attuale' all'oggetto.
Creare una casella di testo finale da mostrare quando è stata avviata la sessione dell'utente nell'applicazione.
Procedere come indicato di seguito:
-
Utilizzando l'oggetto grafico Testo e immagine, creare una casella di testo.
-
Aggiungere la seguente misura all'oggetto:
=vApplicationOpened
-
In Aspetto, selezionare Show titles e aggiungere il titolo 'Inizio sessione utente' all'oggetto.
Schema delle variabili create con la funzione today() nello script di caricamento
L'immagine qui sopra mostra dei valori di esempio per ciascuna delle variabili create. Ad esempio, i valori potrebbero essere i seguenti:
-
Ora di ricaricamento precedente: 22/06/2022
-
Ora di ricaricamento attuale: 23/06/2022
-
Inizio della sessione utente: 23/06/2022
Esempio 2 – Generazione di oggetti senza script di caricamento
Panoramica
L'esempio seguente crea tre oggetti grafico utilizzando la funzione today(). Ogni oggetto del grafico utilizza una delle opzioni timer_mode per dimostrarne l'effetto.
Per questo esempio non esiste uno script di caricamento.
Risultati
Una volta che i dati vengono caricati una seconda volta, creare tre caselle di testo.
Per prima cosa, creare una casella di testo per l'ultimo ricaricamento di dati.
Procedere come indicato di seguito:
-
Utilizzando l'oggetto grafico Testo e immagine, creare una casella di testo.
-
Aggiungere la seguente misura.
=today(0)
-
Nella sezione Aspetto, selezionare Mostra titoli e aggiungere il titolo 'Ricaricamento ultimi dati' all'oggetto.
Quindi, creare una casella di testo per mostrare l'ora corrente.
Procedere come indicato di seguito:
-
Utilizzando l'oggetto grafico Testo e immagine, creare una casella di testo.
-
Aggiungere la misura seguente:
=today(1)
-
In Aspetto, selezionare Mostra titoli e aggiungere il titolo 'Ora attuale' all'oggetto.
Creare una casella di testo finale da mostrare quando è stata avviata la sessione dell'utente nell'applicazione.
Procedere come indicato di seguito:
-
Utilizzando l'oggetto grafico Testo e immagine, creare una casella di testo.
-
Aggiungere la misura seguente:
=today(2)
-
In Aspetto, selezionare Mostra titoli e aggiungere il titolo 'Sessione utente iniziata' all'oggetto.
Schema degli oggetti creato usando la funzione today() senza script di caricamento
L'immagine qui sopra mostra dei valori di esempio per ciascuno degli oggetti creati. Ad esempio, i valori potrebbero essere i seguenti:
-
Data ultimo ricaricamento: 23/06/2022
-
Orario corrente: 23/06/2022
-
Inizio della sessione utente: 23/06/2022
L'oggetto grafico 'Ultimo caricamento dati' utilizza un valore timer_mode pari a 0. Restituisce il timestamp dell'ultima volta in cui i dati sono stati ricaricati correttamente.
L'oggetto grafico 'Ora corrente' utilizza un valore timer_mode di 1. Questo restituisce l'ora corrente secondo l'orologio di sistema. Se il foglio o l'oggetto viene ricaricato, questo valore verrà aggiornato.
L'oggetto grafico 'Sessione utente iniziata' utilizza un valore timer_mode di 2. Restituisce il timestamp di quando l'applicazione è stata aperta e la sessione dell'utente è iniziata.