Denna funktion returnerar aktuell tid. Denna funktion returnerar värdet i DateFormat-systemvariabelformat.
Syntax:
today([ timer_mode])
Returnerad datatyp: dual
today()-funktionen kan användas antingen i laddningsskriptet eller i diagramobjekt.
Som standard är timer_mode-värdet 1.
| Argument | Beskrivning |
|---|---|
| timer_mode |
Kan ha följande värden: 0 (dagen för senast avslutade dataladdning) Anteckning om informationOm du använder funktionen i ett laddningsskript, resulterar timer_mode=0 i dagen för senast slutförda dataladdning, medan timer_mode=1 visar dagen för den aktuella dataladdningen.
|
| Värde för timer_mode | Resultat om det används i laddningsskript | Resultat om det används i diagramobjekt |
|---|---|---|
| 0 | Returnerar ett datum, i formatet för systemvariabeln DateFormat, för den sista slutförda dataladdningen före den senaste dataladdningen | Returnerar ett datum, i formatet för systemvariabeln DateFormat, för den senaste dataladdningen. |
|
1 |
Returnerar ett datum, i formatet för systemvariabeln DateFormat, för den senaste dataladdningen. | Returnerar ett datum, i formatet för systemvariabeln DateFormat, för funktionsanropet. |
|
2 |
Returnerar ett datum, i formatet för systemvariabeln DateFormat, för när användarens session i programmet började. Detta uppdateras inte, såvida inte användaren laddar skriptet. | Returnerar datumet, i formatet för systemvariabeln DateFormat, för när användarens session i programmet började. Detta kommer att uppdateras när en ny session börjar eller data i applikationen laddas igen. |
Användning
today()-funktionen används vanligen som en komponenten inom ett uttryck. Den kan exempelvis användas för att beräkna den ränta som har ackumulerats under en månad fram till dagens datum.
I följande tabell finns en förklaring av resultatet som returneras av today()-funktionen, förutsatt att värdena för timer_mode-argumenten är olika:
Lokala inställningar
Om inget annat anges använder exemplen i detta ämne följande datumformat: MM/DD/ÅÅÅÅ. Datumformatet anges i SET DateFormat-satsen i datainläsningsskriptet. Förvald datumformatering kan vara annorlunda i ditt system, på grund av dina regionala inställningar och andra faktorer. Du kan ändra formaten i exemplen nedan så att det passar dina krav. Eller så kan du ändra formaten i ditt laddningsskript så att de matchar dessa exempel.
Standardregionalinställningar i appar baseras på de regionala systeminställningarna för datorn eller servern där Qlik Sense är installerad. Om Qlik Sense-servern du ansluter till är inställd på Sverige så kommer skriptredigeraren använda regionala inställningar för Sverige för datum, tid och valuta. Dessa regionala formatinställningar är inte relaterade till språket som visas i Qlik Sense användargränssnittet. Qlik Sense kommer att visas på samma språk som webbläsaren du använder.
Exempel 1 – generering av objekt med laddningsskript
Översikt
I det följande exemplet skapas tre variabler med today()-funktionen. För varje variabel används ett av timer_mode-alternativen för att visa hur det fungerar.
För att variablernas funktionalitet ska framgå laddar du skriptet en gång, och därefter efter 24 timmar ytterligare en gång. Resultatet blir att today(0)- och today(1)-variablernas funktionalitet framgår genom att de visar olika värden.
Laddningsskript
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);Resultat
När data har lästs in en andra gång, skapar du tre textrutor enligt anvisningarna nedan.
Skapa först en textruta för data som tidigare har lästs in.
Gör följande:
Skapa en textruta genom att använda diagramobjektet Text och bild.
Lägg till följande mått till objektet:
=vPreviousDataLoad
Under Utseende, väljer du Show titles och lägger till rubriken "Tidigare inläsningstid" till objektet.
Skapa sedan en textruta för de data som för närvarande läses in.
Gör följande:
Skapa en textruta genom att använda diagramobjektet Text och bild.
Lägg till följande mått till objektet:
=vCurrentDataLoad
Under Utseende, väljer du Show titles och lägger till rubriken "Aktuell inläsningstid" till objektet.
Skapa en sista textruta för att visa när användarens session i programmet startade.
Gör följande:
Skapa en textruta genom att använda diagramobjektet Text och bild.
Lägg till följande mått till objektet:
=vApplicationOpened
Under Utseende, väljer du Show titles och lägger till rubriken "Användarsession startade" till objektet.
Diagram för variabler som skapats med today()-funktionen i laddningsskript
Bilden ovan visar exempelvärden för var och en av de skapade variablerna. Värdena skulle exempelvis kunna se ut som följer:
Föregående laddningstid: 2022-06-22
Aktuell laddningstid: 2022-06-23
Användarsessionen började: 2022-06-23
Exempel 2 – generering av objekt utan laddningsskript
Översikt
I det följande exemplet skapas tre diagramobjekt med today()-funktionen. För vart och ett av diagramobjekten används ett av timer_mode-alternativen för att visa hur det fungerar.
Det finns inget laddningsskript för det här exemplet.
Resultat
När data har lästs in en andra gång skapar du tre textrutor.
Först skapar du en textruta för den senaste dataladdningen.
Gör följande:
Skapa en textruta genom att använda diagramobjektet Text och bild.
Lägg till följande mått:
=today(0)
Under Utseende, väljer du Visa rubriker och lägger till rubriken "Senaste datainläsning" till objektet.
Skapa sedan en textruta för att visa aktuell tid.
Gör följande:
Skapa en textruta genom att använda diagramobjektet Text och bild.
Lägg till följande mått:
=today(1)
Under Utseende, väljer du Visa rubriker och lägger till rubriken "Aktuell tid" till objektet.
Skapa en sista textruta för att visa när användarens session i programmet startade.
Gör följande:
Skapa en textruta genom att använda diagramobjektet Text och bild.
Lägg till följande mått:
=today(2)
Under Utseende, väljer du Visa rubriker och lägger till rubriken "Användarsession började" till objektet.
Diagram för objekt som skapats med today()-funktionen utan laddningsskript
Bilden ovan visar exempelvärden för vart och ett av de skapade objekten. Värdena skulle exempelvis kunna se ut som följer:
Senaste dataladdning: 2022-06-23
Aktuell tid: 2022-06-23
Användarsessionen började: 2022-06-23
Diagramobjektet "Data laddades senast" använder ett timer_mode-värde på 0. Då returneras tidsmarkören för d en senaste tidpunkten som data senast laddades.
Diagramobjektet "Aktuell tid" använder ett timer_mode-värde på 1. Då returneras den aktuella tiden enligt systemklockan. Om arket eller objektet uppdateras kommer det här värdet att uppdateras.
Diagramobjektet "Användarsessionen började" använder ett timer_mode-värde på 2. Då returneras tidsmarkören för när programmet öppnades, och användarsessionen började.