Deze functie retourneert een tijdstempel van de huidige tijd. Deze functie retourneert waarden in de indeling van de systeemvariabele TimeStamp. De standaardwaarde voor timer_mode is 1.
Syntaxis:
now([ timer_mode])
Retourgegevenstypen: dual
De now()-functie kan ofwel in het load-script ofwel in diagramobjecten worden gebruikt.
| Argument | Beschrijving |
|---|---|
| timer_mode |
Kan de volgende waarden hebben: 0 (tijd van de als laatste voltooide laadbewerking voor gegevens) InformatieAls u de functie gebruikt in een script voor het laden van gegevens, resulteert timer_mode=0 in de tijd van de als laatste voltooide laadbewerking voor gegevens, terwijltimer_mode=1 de tijd van de functieaanroep in de huidige laadbewerking voor gegevens oplevert.
|
Wanneer gebruiken
De now()-functie wordt meestal gebruikt als een component in een uitdrukking. Hij kan bijvoorbeeld worden gebruikt om de resterende tijd te berekenen in een levenscyclus van een project. De now()-functie zou in plaats van de today()-functie worden gebruikt wanneer de uitdrukking het gebruik van een deel van een dag vereist.
De volgende tabel geeft een uitleg van het resultaat dat door de now()-functie is geretourneerd en geeft verschillende waarden voor het timer_mode-argument:
| timer_mode-waarde | Resultaat bij gebruik in load-script | Resultaat bij gebruik in diagramobject |
|---|---|---|
| 0 | Retourneert een tijdstempel met de notatie van de TimeStamp-systeemvariabele, van de laatste keer dat de gegevens opnieuw zijn geladen voorafgaand aan de laatste keer dat de gegevens opnieuw zijn geladen. | Retourneert een tijdstempel met de notatie van de TimeStamp-systeemvariabele voor de laatste keer dat de gegevens opnieuw zijn geladen. |
|
1 |
Retourneert een tijdstempel met de notatie van de TimeStamp-systeemvariabele voor de laatste keer dat de gegevens opnieuw zijn geladen. | Retourneert een tijdstempel met de notatie van de TimeStamp-systeemvariabele van de functieaanroep. |
|
2 |
Retourneert een tijdstempel met de notatie van de TimeStamp-systeemvariabele voor het begin van de sessie van de gebruiker in de applicatie. Dit wordt niet bijgewerkt tenzij de gebruiker het script opnieuw laadt. | Retourneert een tijdstempel met de notatie van de TimeStamp-systeemvariabele voor het begin van de sessie van de gebruiker in de applicatie. Dit wordt vernieuwd zodra een nieuwe sessie begint of de gegevens weer in de applicatie zijn geladen. |
Landinstellingen
Tenzij anders aangegeven, wordt in de voorbeelden in dit onderwerp de volgende datumindeling gebruikt: MM/DD/JJJJ. De datumopmaak wordt opgegeven in de opdracht SET DateFormat in uw script voor het laden van gegevens. De standaard datumindeling is mogelijk anders op uw systeem vanwege landinstellingen en andere factoren. U kunt de indelingen in de voorbeelden wijzigen zodat deze aansluiten op uw behoeften. Of u kunt de indelingen in uw load-script wijzigen zodat ze overeenkomen met deze voorbeelden. Ga voor meer informatie naar Regionale instellingen voor apps en scripts aanpassen.
Standaard landinstellingen van de app zijn gebaseerd op het gebruikersprofiel. Deze landinstellingen voor indelingen zijn niet gerelateerd aan de taal die wordt weergegeven in de gebruikersinterface van Qlik Cloud. Qlik Cloud wordt weergegeven in dezelfde taal als de browser die u gebruikt.
Als u een app-ontwikkelaar bent, kunt u de standaardregio instellen voor apps die u maakt. Ga voor meer informatie naar Instellen van uw voorkeur voor regionale instellingen voor het maken van apps en scripts in Qlik Cloud Analyse.
Voorbeeld 1 – Genereren van objecten met behulp van het load-script
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Dit voorbeeld creëert die variabelen met behulp van de now()-functie. Elke variabele gebruikt een van de timer_mode-opties om het effect van de variabele te demonstreren.
Laad het script opnieuw en herlaad het na een korte tijdsperiode zodat de variabelen hun doel kunnen laten zien. De variabelen now(0) en now(1) zullen nu verschillende waarden laten zien en hun doel demonstreren.
Load-script
LET vPreviousDataLoad = now(0);
LET vCurrentDataLoad = now(1);
LET vApplicationOpened = now(2);Resultaten
Nadat de gegevens voor de tweede keer zijn geladen, maakt u drie tekstvakken door de onderstaande instructies te volgen.
Maak eerst een tekstvak voor de gegevens die eerder zijn geladen.
Doe het volgende:
-
Gebruik het diagramobject Tekst en afbeelding om een tekstvak te maken.
-
Voeg de volgende meting toe aan het object:
=vPreviousDataLoad
-
Onder Uiterlijk selecteert u Show titles en voegt u de titel 'Previous Reload Time' toe aan het object.
Maak vervolgens een tekstvak voor de gegevens die momenteel worden geladen.
Doe het volgende:
-
Gebruik het diagramobject Tekst en afbeelding om een tekstvak te maken.
-
Voeg de volgende meting toe aan het object:
=vCurrentDataLoad
-
Onder Uiterlijk selecteert u Show titles en voegt u de titel 'Current Reload Time' toe aan het object.
Maak een definitief tekstvak dat wordt getoond als de sessie van de gebruiker in de toepassing wordt gestart.
Doe het volgende:
-
Gebruik het diagramobject Tekst en afbeelding om een tekstvak te maken.
-
Voeg de volgende meting toe aan het object:
=vApplicationOpened
-
Onder Uiterlijk selecteert u Show titles en voegt u de titel 'User Session Started' toe aan het object.
now()-load-scriptvariabelen
De bovenstaande afbeelding geeft voorbeeldwaarden weer voor elk van de gemaakte variabelen. De waarden zouden bijvoorbeeld als volgt kunnen zijn:
-
Vorige herlaadtijd: 6/22/2022 8:54:03 AM
-
Huidige herlaadtijd: 6/22/2022 9:02:08 AM
-
Start gebruikerssessie: 6/22/2022 8:40:40 AM
Voorbeeld 2 – Genereren van objecten zonder het load-script
Overzicht
In dit voorbeeld maakt u drie diagramobjecten met de now()-functie zonder dat er variabelen of gegevens in de applicatie worden geladen. Elk diagramobject gebruikt een van de timer_mode-opties om het effect te demonstreren.
Er is geen load-script voor dit voorbeeld.
Doe het volgende:
-
Open de editor voor laden van gegevens.
-
Klik zonder het bestaande load-script te wijzigen op Gegevens laden.
-
Laad het script na korte tijd nog een tweede keer.
Resultaten
Maak drie tekstvakken zodra de gegevens voor een tweede keer zijn geladen.
Maak eerst een tekstvak voor de laatste keer dat de gegevens opnieuw zijn geladen.
Doe het volgende:
-
Gebruik het diagramobject Tekst en afbeelding om een tekstvak te maken.
-
Voeg de volgende meting toe:
=now(0)
-
Onder Uiterlijk selecteert u Titels tonenen voegt u de titel Laatste herlaadtijd gegevens toe aan het object.
Maak nu een tekstvak om de actuele tijd te tonen.
Doe het volgende:
-
Gebruik het diagramobject Tekst en afbeelding om een tekstvak te maken.
-
Voeg de volgende meting toe:
=now(1)
-
Onder Uiterlijk selecteert u Titels tonen en voegt u de titel Actuele tijd toe aan het object.
Maak een definitief tekstvak dat wordt getoond als de sessie van de gebruiker in de toepassing wordt gestart.
Doe het volgende:
-
Gebruik het diagramobject Tekst en afbeelding om een tekstvak te maken.
-
Voeg de volgende meting toe:
=now(2)
-
Onder Uiterlijk selecteert u Titels tonen en voegt u de titel Start gebruikerssessie toe aan het object.
Voorbeelden van now()-diagramobject
De bovenstaande afbeelding geeft voorbeeldwaarden weer voor elk van de gemaakte objecten. De waarden zouden bijvoorbeeld als volgt kunnen zijn:
-
Laatste herlaadtijd gegevens: 6/22/2022 9:02:08 AM
-
Huidige tijd: 6/22/2022 9:25:16 AM
-
Start gebruikerssessie: 6/22/2022 8:40:40 AM
Het diagramobject Laatste herlaadtijd gegevens maakt gebruik van een timer_mode-waarde van 0. Dit retourneert de tijdstempel voor de laatste keer dat de gegevens opnieuw zijn geladen.
Het diagramobject Actuele tijd gebruikt een timer_mode-waarde van 1. Dit retourneert de actuele tijd volgens de systeemklok. Als het werkblad of object wordt vernieuwd, wordt deze waarde bijgewerkt.
Het diagramobject Start gebruikerssessie gebruikt een timer_mode-waarde van 2. Dit retourneert de tijdstempel voor het moment waarop de applicatie werd geopend en waarop de gebruikerssessie is begonnen.