Questa funzione restituisce un indicatore temporale dell'ora attuale. La funzione restituisce i valori nel formato della variabile di sistema TimeStamp. Il valore predefinito timer_mode è 1.
Sintassi:
now([ timer_mode])
Tipo di dati restituiti: duale
La funzione now() può essere utilizzata sia nello script di caricamento che negli oggetti del grafico.
| Argomento | Descrizione |
|---|---|
| timer_mode |
Può presentare i valori seguenti: 0 (ora al momento dell'ultimo caricamento di dati completato) Nota informaticaSe si utilizza la funzione in uno script di caricamento dei dati, timer_mode=0 restituirà l'ora del completamento dell'ultimo caricamento dei dati, mentre timer_mode=1 restituirà l'ora della chiamata di funzione nel caricamento dei dati attuale.
|
Casi di utilizzo
La funzione now() viene comunemente utilizzata come componente di un'espressione. Ad esempio, può essere utilizzato per calcolare il tempo rimanente nel ciclo di vita di un prodotto. La funzione now() verrebbe utilizzata al posto della funzione today() quando l'espressione richiede l'uso di una frazione di giorno.
La tabella seguente fornisce una spiegazione del risultato restituito dalla funzione now(), in presenza di diversi valori dell'argomento timer_mode:
| valore timer_mode | Risultato se utilizzato nello script di caricamento | Risultato se utilizzato nell'oggetto grafico |
|---|---|---|
| 0 | Restituisce un timestamp, nel formato della variabile di sistema TimeStamp, dell'ultimo ricaricamento dei dati riuscito prima dell'ultimo ricaricamento dei dati. | Restituisce un timestamp, nel formato della variabile di sistema TimeStamp, per l'ultimo ricaricamento dei dati. |
|
1 |
Restituisce un timestamp, nel formato della variabile di sistema TimeStamp, per l'ultimo ricaricamento dei dati. | Restituisce un timestamp, nel formato della variabile di sistema TimeStamp, della chiamata alla funzione. |
|
2 |
Restituisce un timestamp, nel formato della variabile di sistema TimeStamp, per l'inizio della sessione dell'utente nell'applicazione. Non verrà aggiornato a meno che l'utente non ricarichi lo script. | Restituisce il timestamp, nel formato della variabile di sistema TimeStamp, per l'inizio della sessione dell'utente nell'applicazione. Questo verrà aggiornato all'inizio di una nuova sessione o quando i dati dell'applicazione verranno ricaricati. |
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.
Le impostazioni regionali predefinite delle app si basano sulle impostazioni regionali del sistema del computer o del server in cui risulta installato Qlik Sense. Se il server Qlik Sense a cui si accede è impostato in Svezia, l'editor caricamento dati utilizzerà le impostazioni regionali svedesi per date, ora e valuta. Queste impostazioni di formato regionale non riguardano la lingua visualizzata nell'interfaccia utente Qlik Sense. Qlik Sense verrà visualizzato nella stessa lingua del browser utilizzato.
Esempio 1 – Generazione di oggetti tramite script di caricamento
Panoramica
Aprire l'Editor di caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Questo esempio crea tre variabili utilizzando la funzione now(). Ogni variabile utilizza una delle opzioni timer_mode per dimostrarne l'effetto.
Affinché le variabili dimostrino il loro scopo, e lo script e poi, dopo un breve periodo di tempo, ricaricare lo script una seconda volta. In questo modo le variabili now(0) e now(1) mostreranno valori diversi, dimostrando così correttamente il loro scopo.
Script di caricamento
LET vPreviousDataLoad = now(0);
LET vCurrentDataLoad = now(1);
LET vApplicationOpened = now(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.
Variabili dello script di caricamento now()
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 8:54:03 AM
-
Ora di ricaricamento corrente: 22/06/2022 9:02:08 AM
-
Inizio della sessione utente: 22/06/2022 8:40:40 AM
Esempio 2 – Generazione di oggetti senza script di caricamento
Panoramica
In questo esempio, si creeranno tre oggetti grafico utilizzando la funzione now(), senza caricare alcuna variabile o dato nell'applicazione. Ogni oggetto del grafico utilizza una delle opzioni timer_mode per dimostrarne l'effetto.
Per questo esempio non esiste uno script di caricamento.
Procedere come indicato di seguito:
-
Aprire l'editor di caricamento dati.
-
Senza modificare lo script di caricamento esistente, fare clic su Carica dati.
-
Dopo un breve periodo di tempo, caricare lo script una seconda volta.
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.
=now(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:
=now(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:
=now(2)
-
In Aspetto, selezionare Mostra titoli e aggiungere il titolo 'Sessione utente iniziata' all'oggetto.
Esempi oggetto grafico now()
L'immagine qui sopra mostra dei valori di esempio per ciascuno degli oggetti creati. Ad esempio, i valori potrebbero essere i seguenti:
-
Dati ultimo ricaricamento: 22/6/2022 9:02:08 AM
-
Ora corrente: 22/6/2022 9:25:16 AM
-
Inizio della sessione utente: 22/06/2022 8:40:40 AM
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.