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.
Argumenten
Argument
Beschrijving
timer_mode
Kan de volgende waarden hebben:
0 (dag van de als laatste voltooide laadbewerking voor gegevens) 1 (dag van de functieaanroep) 2 (dag wanneer de app werd geopend)
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.
Voorbeelden van functies
timer_mode-waarde
Resultaat bij gebruik in load-script
Resultaat bij gebruik in diagramobject
0
Retourneert een datum met de notatie van de systeemvariabeleDateFormat, 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. 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.
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.
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 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:
=today(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:
=today(2)
Onder Uiterlijk selecteert u Titels tonen en voegt u de titel Start gebruikerssessie toe aan het object.
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.
Voorbeeld 3 – Scenario
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad.
Het load-script bevat:
Een gegevensverzameling met een set leningsaldo's die wordt geladen in de tabel Loans.
Tabelgegevens met velden voor lening-id, saldo aan het begin van de maand en de enkelvoudige rente die op elke lening per jaar wordt berekend.
De eindgebruiker wil een diagramobject dat per lening-id de huidige rente weergeeft die is opgebouwd op elke lening in de maand tot heden. De applicatie wordt slechts eens per week opnieuw geladen, maar de gebruiker wil graag dat de resultaten worden vernieuwd zodra het object of de applicatie wordt vernieuwd.
De functie monthstart() gebruikt de functie today() om de datum van vandaag als enige argument te retourneren en retourneert de begindatum van de huidige maand. Door dat resultaat af te trekken van de huidige datum en de today()-functie opnieuw te gebruiken, retourneert de uitdrukking het aantal dagen dat in deze maand tot nu toe is verstreken.
Deze waarde wordt vervolgens vermenigvuldigd met het rentepercentage en gedeeld door 365 om het effectieve rentepercentage voor deze periode te retourneren. Het resultaat wordt vervolgens vermenigvuldigd met het beginsaldo van de lening om de rente terug te betalen die deze maand tot nu toe is opgebouwd.
Omdat de waarde 1 is gebruikt als het timer_mode-argument in de today()-functies in de uitdrukking, wordt elke keer dat het diagramobject wordt vernieuwd (door de applicatie te openen, de pagina te vernieuwen, tussen werkbladen te wisselen, enzovoort) de huidige datum geretourneerd en worden de resultaten overeenkomstig vernieuwd.
Was deze pagina nuttig?
Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!