Datum- en tijdfuncties
Datum- en tijdfuncties in Qlik Sense worden gebruikt voor het transformeren en converteren van datum- en tijdwaarden. Alle functies kunnen zowel worden gebruikt in het script voor het laden van gegevens als in diagramuitdrukkingen.
Functies zijn gebaseerd op een serienummer voor datum-tijd dat gelijk is aan het aantal dagen sinds 30 december 1899. De waarde van het gehele getal geeft de dag aan en de fractionele waarde geeft de tijd van de dag aan.
In Qlik Sense wordt de numerieke waarde van de parameter gebruikt, dus een getal is geldig als parameter ook als het niet is opgemaakt als een datum of tijd. Als de parameter niet overeenkomt met een numerieke waarde, bijvoorbeeld als het een tekenreeks is, wordt in Qlik Sense geprobeerd om de tekenreeks te interpreteren op basis van de omgevingsvariabelen voor datum en tijd.
Als de tijdnotatie die in de parameter wordt gebruikt niet overeenkomt met de notatie die is ingesteld in de omgevingsvariabelen, is geen correcte interpretatie in Qlik Sense mogelijk. U kunt dit oplossen door de instellingen te wijzigen of gebruik te maken van een interpretatiefunctie.
In de voorbeelden voor elke functie wordt uitgegaan van de standaardnotatie voor tijd en datum, hh:mm:ss en YYYY-MM-DD (ISO 8601).
Bij Het verwerken van een tijdsstempel met een datum- of tijdfunctie, negeert Qlik Sense zomertijdparameters tenzij de datum- of tijdfunctie een geografische positie bevat.
ConvertToLocalTime( filetime('Time.qvd'), 'Paris') gebruikt bijvoorbeeld wel zomertijdparameters terwijl ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') geen zomertijdparameters gebruikt.
Gebruik de vervolgkeuzelijst bij elke functie om een korte beschrijving en de syntaxis van de functie te bekijken. Klik op de functienaam in de beschrijving van de syntaxis voor meer informatie.
Uitdrukkingen van tijd in gehele getallen
Deze functie retourneert een geheel getal dat de seconde representeert als de breuk van de expression wordt geïnterpreteerd als een datum volgens de standaardinterpretatie van getallen.
second(expression)
Deze functie retourneert een geheel getal dat de minuut representeert als de breuk van de expression wordt geïnterpreteerd als een datum volgens de standaardinterpretatie van getallen.
minute(expression)
Deze functie retourneert een geheel getal dat het uur representeert als de breuk van de expression wordt geïnterpreteerd als een datum volgens de standaardinterpretatie van getallen.
hour(expression)
Deze functie retourneert een geheel getal dat de dag representeert als de breuk van expression wordt geïnterpreteerd als een datum volgens de standaardinterpretatie van getallen.
day(expression)
Deze functie retourneert een geheel getal dat het weeknummer representeert conform ISO 8601. Het weeknummer wordt berekend volgens de datuminterpretatie van de uitdrukking, in overeenstemming met de standaardinterpretatie van getallen.
week(expression)
Deze functie retourneert een duale waarde: een maandnaam zoals vastgelegd in de omgevingsvariabele MonthNames, en een geheel getal tussen 1-12. De maand wordt berekend volgens de datuminterpretatie van de uitdrukking, in overeenstemming met de standaardinterpretatie van getallen.
month(expression)
Deze functie retourneert een geheel getal dat het jaar representeert als de expression wordt geïnterpreteerd als een datum volgens de standaardinterpretatie van getallen.
year(expression)
Deze functie retourneert het jaar waarbij het weeknummer hoort, op basis van de omgevingsvariabelen. Het weeknummer varieert van 1 tot ongeveer 52.
weekyear(expression)
Deze functie retourneert een duale waarde met:
- De naam van een dag zoals gedefinieerd in de omgevingsvariabele DayNames.
- Een geheel getal tussen 0 en 6 dat overeenkomt met de nominale dag van de week (0-6).
weekday(date)
Tijdstempelfuncties
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.
now([ timer_mode])
Deze functie retourneert de huidige datum. Deze functie retourneert waarden in de indeling van de systeemvariabele DateFormat.
today([timer_mode])
Deze functie retourneert een tijdstempel met de huidige tijd voor een opgegeven tijdzone.
localtime([timezone [, ignoreDST ]])
Maakfuncties
Deze functie retourneert een datum die is berekend voor het jaar YYYY, de maand MM en de dag DD.
makedate(YYYY [ , MM [ , DD ] ])
Deze functie retourneert een datum die is berekend voor het jaar, het weeknummer en de dag van de week.
makeweekdate(YYYY [ , WW [ , D ] ])
Deze functie retourneert een tijd die is berekend voor het uur hh, de minuut mm en de seconde ss.
maketime(hh [ , mm [ , ss [ .fff ] ] ])
Andere datumfuncties
Deze functie retourneert de datum n maanden na startdate of, als n negatief is, de datum n maanden vóór startdate.
addmonths(startdate, n , [ , mode])
Deze functie retourneert de datum n jaar na startdate of, als n negatief is, de datum n jaar vóór startdate.
addyears(startdate, n)
Deze functie bepaalt of de invoertijdstempel binnen het jaar valt waarin het script voor het laatst is geladen en retourneert True als dat het geval is en False als dat niet het geval is.
yeartodate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])
TimeZone-functies
De functie retourneert de tijdzone zoals gedefinieerd op de computer waarop de Qlik-engine wordt uitgevoerd.
timezone( )
Deze functie retourneert de huidige Greenwich Mean Time, zoals afgeleid uit de landinstellingen.
GMT( )
Retourneert de huidige Coordinated Universal Time.
UTC( )
Retourneert de huidige aanpassing voor zomertijd zoals die in Windows is gedefinieerd.
Converteert een UTC- of GMT-tijdstempel naar een lokale tijd met twee representaties. De plaats kan een reeks steden, plaatsen en tijdzones overal ter wereld zijn.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
Functies voor instellen van tijd
Deze functie neemt een timestamp en een year als invoer en werkt de timestamp bij met het year dat is opgegeven in de invoer.
setdateyear (timestamp, year)
Deze functie neemt een timestamp, een month en een year als invoer en werkt de timestamp bij met het year en de month die zijn opgegeven in de invoer.
setdateyearmonth (timestamp, year, month)
Functies In...
Deze functie retourneert True als timestamp binnen het jaar valt dat base_date bevat.
inyear(date, basedate , shift [, first_month_of_year = 1])
Deze functie retourneert True als timestamp binnen het gedeelte van het jaar ligt dat base_date bevat tot en met de laatste milliseconde van base_date.
inyeartodate (date, basedate , shift [, first_month_of_year = 1])
Deze functie retourneert True als timestamp binnen het kwartaal valt dat base_date bevat.
inquarter (date, basedate , shift [, first_month_of_year = 1])
Deze functie retourneert True als timestamp binnen het gedeelte van het kwartaal ligt dat base_date bevat tot en met de laatste milliseconde van base_date.
inquartertodate (date, basedate , shift [, first_month_of_year = 1])
Deze functie retourneert True als timestamp in de maand valt die base_date bevat.
inmonth(date, basedate , shift)
Retourneert True als date binnen het gedeelte van de maand ligt dat basedate bevat tot en met de laatste milliseconde van basedate.
inmonthtodate (date, basedate , shift)
Deze functie bepaalt of een tijdstempel valt binnen dezelfde periode van de maand, twee maanden, kwartaal, tertiaal of half jaar als basisdatum. Het is tevens mogelijk om te bepalen of de tijdstempel binnen een voorafgaande of volgende tijdsperiode valt.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
Deze functie bepaalt of een tijdstempel binnen het gedeelte van een periode van de maand, twee maanden, kwartaal, tertiaal of half jaar tot en met de laatste milliseconde van base_date valt. Het is tevens mogelijk om te bepalen of de tijdstempel binnen een voorafgaande of volgende tijdsperiode valt.
inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])
Deze functie retourneert True als timestamp binnen de week valt die base_date bevat.
inweek(date, basedate , shift [, weekstart])
Deze functie retourneert True als timestamp binnen het gedeelte van de week ligt dat base_date bevat tot en met de laatste milliseconde van base_date.
inweektodate (date, basedate , shift [, weekstart])
Deze functie bepaalt of timestamp binnen de maanweek valt die base_date bevat. Maanweken in Qlik Sense worden gedefinieerd door het feit dat 1 januari wordt gezien als de eerste dag van de week. Met uitzondering van de laatste week van het jaar, bevat elke week precies zeven dagen.
inlunarweek (date, basedate , shift [, weekstart])
Met deze functie wordt bepaald of timestamp binnen het gedeelte van de maanweek ligt tot en met de laatste milliseconde van base_date. Maanweken in Qlik Sense worden gedefinieerd door het feit dat 1 januari wordt gezien als de eerste dag van de week en, met uitzondering van de laatste week van het jaar, bevat elke week precies zeven dagen.
inlunarweektodate (date, basedate , shift [, weekstart])
Deze functie retourneert True als timestamp binnen de dag valt die base_timestamp bevat.
inday(timestamp, basetimestamp , shift [, daystart])
Deze functie retourneert True als timestamp binnen het gedeelte van de dag ligt dat base_timestamp bevat tot en met de exacte milliseconde van base_timestamp.
indaytotime(timestamp, basetimestamp , shift [, daystart])
Functies Begin ... Eind
Deze functie retourneert een tijdsstempel die overeenkomt met het begin van de eerste dag van het jaar dat date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
yearstart( date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de laatste milliseconde van de laatste dag van het jaar dat date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
yearend( date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert een jaar in vier cijfers als weergavewaarde met een onderliggende numerieke waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van het jaar dat date bevat.
yearname(date [, shift = 0 [, first_month_of_year = 1]] )
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de eerste milliseconde van het kwartaal dat date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
quarterstart(date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de laatste milliseconde van het kwartaal dat date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
quarterend(date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert de maanden van het kwartaal (opgemaakt volgens de scriptvariabele MonthNames) en het jaar met een onderliggende numerieke waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van het kwartaal.
quartername(date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de maand die date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
monthstart(date [, shift = 0])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de laatste milliseconde van de laatste dag van de maand die date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
monthend(date [, shift = 0])
Deze functie retourneert de maand (opgemaakt volgens de scriptvariabele MonthNames) en het jaar met een onderliggende numerieke waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de maand.
monthname(date [, shift = 0])
Deze functie retourneert een waarde die overeenkomt met de tijdstempel van de eerste milliseconde van de periode van een maand, twee maanden, kwartaal, tertiaal of half jaar die een basisdatum bevat. Het is tevens mogelijk om de tijdstempel voor een voorafgaande of volgende tijdsperiode te bepalen.De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de laatste milliseconde van de periode van een maand, twee maanden, kwartaal, tertiaal of half jaar die een basisdatum bevat. Het is tevens mogelijk om de tijdstempel voor een voorafgaande of volgende tijdsperiode te bepalen.
monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert een weergavewaarde die het bereik vertegenwoordigt van de maanden van de periode (geformatteerd volgens de scriptvariabele MonthNames) alsmede het jaar. De onderliggende numerieke waarde komt overeen met een tijdstempel van de eerste milliseconde van de periode van een maand, twee maanden, kwartaal, tertiaal of half jaar die een basisdatum bevat.
monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de kalenderweek die date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
weekstart(date [, shift = 0 [,weekoffset = 0]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de laatste milliseconde van de laatste dag van de kalenderweek die date bevat. De standaarduitvoernotatie is de DateFormat die is ingesteld in het script.
weekend(date [, shift = 0 [,weekoffset = 0]])
Deze functie retourneert het jaar en weeknummer met een onderliggende numerieke waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de week die date bevat.
weekname(date [, shift = 0 [,weekoffset = 0]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de maanweek die date bevat. Maanweken in Qlik Sense worden gedefinieerd door het feit dat 1 januari wordt gezien als de eerste dag van de week en, met uitzondering van de laatste week van het jaar, bevat elke week precies zeven dagen.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de laatste milliseconde van de laatste dag van de maanweek die date bevat. Maanweken in Qlik Sense worden gedefinieerd door het feit dat 1 januari wordt gezien als de eerste dag van de week en, met uitzondering van de laatste week van het jaar, bevat elke week precies zeven dagen.
lunarweekend(date [, shift = 0 [,weekoffset = 0]])
Deze functie retourneert een weergavewaarde voor het jaar en maanweeknummer dat overeenkomt met een tijdstempel van de eerste milliseconde van de eerste dag van de week die date bevat. Maanweken in Qlik Sense worden gedefinieerd door het feit dat 1 januari wordt gezien als de eerste dag van de week en, met uitzondering van de laatste week van het jaar, bevat elke week precies zeven dagen.
lunarweekname(date [, shift = 0 [,weekoffset = 0]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel met de eerste milliseconde van de dag in het argument time. De standaarduitvoernotatie is de TimestampFormat die is ingesteld in het script.
daystart(timestamp [, shift = 0 [, dayoffset = 0]])
Deze functie retourneert een waarde die overeenkomt met een tijdstempel van de laatste milliseconde van de dag in time. De standaarduitvoernotatie is de TimestampFormat die is ingesteld in het script.
dayend(timestamp [, shift = 0 [, dayoffset = 0]])
Deze functie retourneert een datum met een onderliggende numerieke waarde die overeenkomt met een tijdstempel van de eerste milliseconde van de dag met time.
dayname(timestamp [, shift = 0 [, dayoffset = 0]])
Functies voor dagnummering
De functie age retourneert de leeftijd op het tijdstip van de timestamp (in voltooide jaren) van iemand die is geboren op date_of_birth.
age(timestamp, date_of_birth)
De functie networkdays retourneert het aantal werkdagen (maandag-vrijdag) tussen start_date en end_date, waarbij rekening wordt gehouden met een eventueel opgegeven holiday.
networkdays (start:date, end_date {, holiday})
De functie firstworkdate retourneert de laatste begindatum waarbij no_of_workdays (maandag-vrijdag) kan worden gehaald als niet later wordt gestopt dan end_date, waarbij rekening wordt gehouden met een eventueel opgegeven vakantiedagen. end_date en holiday moeten geldige datums of tijdstempels zijn.
firstworkdate(end_date, no_of_workdays {, holiday} )
De functie lastworkdate retourneert de vroegste einddatum waarbij no_of_workdays (maandag-vrijdag) kan worden gehaald als wordt begonnen op start_date , waarbij rekening wordt gehouden met een eventueel opgegeven holiday. start_date en holiday moeten geldige datums of tijdstempels zijn.
lastworkdate(start_date, no_of_workdays {, holiday})
Deze functie berekent het dagnummer van het jaar waarbinnen een tijdstempel valt. De berekening wordt uitgevoerd vanaf de eerste milliseconde van de eerste dag van het jaar, maar de beginmaand kan worden verschoven.
daynumberofyear(date[,firstmonth])
Deze functie berekent het dagnummer van het kwartaal waarbinnen een tijdstempel valt. Deze functie wordt gebruikt wanneer een masterkalender wordt gemaakt.
daynumberofquarter(date[,firstmonth])