Deze functie retourneert de huidige datum. Deze functie retourneert waarden in de indeling van de systeemvariabele DateFormat.
Syntaxis:
today([ timer_mode])
Retourgegevenstypen: dual
De today()-functie kan ofwel in het load-script ofwel in diagramobjecten worden gebruikt.
De standaardwaarde voor timer_mode is 1.
| Argument | Beschrijving |
|---|---|
| timer_mode |
Kan de volgende waarden hebben: 0 (dag van de als laatste voltooide laadbewerking voor gegevens) InformatieAls u de functie in een load-script gebruikt, resulteert timer_mode=0 in de dag van de als laatste voltooide laadbewerking voor gegevens, terwijl timer_mode=1 de dag van de functieaanroep in de huidige laadbewerking voor gegevens oplevert.
|
| timer_mode-waarde | Resultaat bij gebruik in load-script | Resultaat bij gebruik in diagramobject |
|---|---|---|
| 0 | Retourneert een datum met de notatie van de systeemvariabele DateFormat, van de laatste keer dat de gegevens opnieuw zijn geladen voorafgaand aan de laatste keer dat de gegevens opnieuw zijn geladen. | Retourneert een datum met de notatie van de systeemvariabele DateFormat voor de laatste keer dat de gegevens opnieuw zijn geladen. |
|
1 |
Retourneert een datum met de notatie van de systeemvariabele DateFormat voor de laatste keer dat de gegevens opnieuw zijn geladen. | Retourneert een datum met de notatie van de systeemvariabele DateFormat van de functieaanroep. |
|
2 |
Retourneert een datum met de notatie van de systeemvariabele DateFormat voor het begin van de sessie van de gebruiker in de applicatie. Dit wordt niet bijgewerkt tenzij de gebruiker het script opnieuw laadt. | Retourneert de datum met de notatie van de systeemvariabele DateFormat 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. |
Wanneer gebruiken
De today()-functie wordt meestal gebruikt als een component in een uitdrukking. Hij kan bijvoorbeeld worden gebruikt om de rente te berekenen die in een maand tot nu toe is opgebouwd.
De volgende tabel geeft een uitleg van het resultaat dat door de today()-functie is geretourneerd en geeft verschillende waarden voor het timer_mode-argument:
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.
Standaard landinstellingen in apps zijn gebaseerd op de regionale systeeminstellingen van de computer of server waarop Qlik Sense is geïnstalleerd. Als de Qlik Sense-server die u gebruikt is ingesteld op Zweden, gebruikt de editor voor laden van gegevens de Zweedse landinstellingen voor datums, tijd en valuta. Deze landinstellingen voor indelingen zijn niet gerelateerd aan de taal die wordt weergegeven in de gebruikersinterface van Qlik Sense. Qlik Sense wordt weergegeven in dezelfde taal als de browser die u gebruikt.
Voorbeeld 1 – Genereren van objecten met behulp van het load-script
Overzicht
Het volgende voorbeeld creëert die variabelen met behulp van de today()-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 24 nog een keer zodat de variabelen hun doel kunnen laten zien. De variabelen today(0) en today(1) zullen nu verschillende waarden laten zien en hun doel demonstreren.
Load-script
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(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.
Diagram van variabelen die zijn gemaakt met de today()-functie in het load-script
De bovenstaande afbeelding geeft voorbeeldwaarden weer voor elk van de gemaakte variabelen. De waarden zouden bijvoorbeeld als volgt kunnen zijn:
-
Vorige herlaadtijd: 06/22/2022
-
Huidige herlaadtijd: 06/23/2022
-
Start gebruikerssessie: 06/23/2022
Voorbeeld 2 – Genereren van objecten zonder het load-script
Overzicht
Het volgende voorbeeld creëert die variabelen met behulp van de today()-functie. Elk diagramobject gebruikt een van de timer_mode-opties om het effect te demonstreren.
Er is geen load-script voor dit voorbeeld.
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:
=today(0)
-
Onder Uiterlijk selecteert u Show titles en 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:
=today(1)
-
Onder Uiterlijk selecteert u Show titles 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:
=today(2)
-
Onder Uiterlijk selecteert u Show titles en voegt u de titel Start gebruikerssessie toe aan het object.
Diagram van objecten die zijn gemaakt met de today()-functie zonder het load-script
De bovenstaande afbeelding geeft voorbeeldwaarden weer voor elk van de gemaakte objecten. De waarden zouden bijvoorbeeld als volgt kunnen zijn:
-
Laatste herlaadtijd gegevens: 06/23/2022
-
Actuele tijd: 06/23/2022
-
Start gebruikerssessie: 06/23/2022
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.