Qlik Sense tarih ve saat fonksiyonları, tarih ve saat değerlerini dönüştürmek için kullanılır. Tüm fonksiyonlar hem veri kod dosyasında hem de grafik ifadelerinde kullanılabilir.
Fonksiyonlar, 30 Aralık 1899'dan beri gün sayısına eşit olan tarih-saat seri numarasını temel alır. Tamsayı değeri günü ve kesir değeri günün saatini temsil eder.
Qlik Sense parametrenin sayısal değerini kullandığından, bir sayı tarih veya saat olarak biçimlendirilmemiş olsa bile parametre olarak geçerlidir. Parametre, örneğin bir dize olması nedeniyle sayısal değere karşılık gelmiyorsa, Qlik Sense bu dizeyi tarih ve saat ortam değişkenlerine göre yorumlamaya çalışır.
Parametrede kullanılan saat biçimi ortam değişkenlerinde ayarlanan biçime karşılık gelmiyorsa, Qlik Sense doğru bir yorumlama yapamaz. Bu sorunu çözmek için ayarları değiştirin veya bir yorumlama fonksiyonunu kullanın.
Her bir fonksiyona ilişkin örneklerde, varsayılan saat ve tarih biçimlerinin hh:mm:ss ve YYYY-MM-DD (ISO 8601) olduğu varsayılmaktadır.
Qlik Sense, tarih veya zaman fonksiyonu olan bir zaman damgasını işlerken tarih veya zaman fonksiyonu bir coğrafi konum içermediği sürece yaz saati parametrelerini yoksayar.
Örneğin, ConvertToLocalTime( filetime('Time.qvd'), 'Paris') tarafından yaz saati parametreleri kullanılırken ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') tarafından kullanılmaz.
Her bir fonksiyonun kısa açıklamasını ve söz dizimini görmek için her bir fonksiyonun açılan menüsünü kullanın. Daha ayrıntılı bilgiler için söz dizimi açıklamasında fonksiyon adına tıklayın.
Tamsayı zaman ifadeleri
Bu fonksiyon, expression öğesinin kesri standart sayı yorumlamasına göre saat olarak yorumlandığında, saniyeyi temsil eden bir tamsayı döndürür.
second(expression)
Bu fonksiyon, expression öğesinin kesri standart sayı yorumlamasına göre saat olarak yorumlandığında, dakikayı temsil eden bir tamsayı döndürür.
minute(expression)
Bu fonksiyon, expression öğesinin kesri standart sayı yorumlamasına göre saat olarak yorumlandığında, saati temsil eden bir tamsayı döndürür.
hour(expression)
Bu fonksiyon, expression öğesinin kesri standart sayı yorumlamasına göre tarih olarak yorumlandığında, günü temsil eden bir tamsayı döndürür.
day(expression)
Bu fonksiyon, ISO 8601 uyarınca hafta numarasını temsil eden bir tamsayı döndürür. Hafta numarası, standart sayı yorumlamasına göre ifadenin tarih yorumlamasından hesaplanır.
week(expression)
Bu fonksiyon, ikili değer döndürür: MonthNames ortam değişkeninde tanımlandığı şekliyle ay adı ve 1-12 arasında bir tamsayı. Ay, standart sayı yorumlamasına göre ifadenin tarih yorumlamasından hesaplanır.
month(expression)
Bu fonksiyon, expression öğesi standart sayı yorumlamasına göre tarih olarak yorumlandığında, yılı temsil eden bir tamsayı döndürür.
year(expression)
Bu fonksiyon, ISO 8601 uyarınca hafta numarasının ait olduğu yılı döndürür. Hafta sayısı, 1 ve yaklaşık 52 arasında değişir.
weekyear(expression)
Bu fonksiyon şunları içeren bir ikili değer döndürür:
- DayNames ortam değişkeninde tanımlanan bir gün adı.
- Haftanın nominal gününe karşılık gelen 0-6 arasında bir tamsayı (0-6).
weekday(date)
Zaman damgası fonksiyonları
Bu fonksiyon geçerli zamanın zaman damgasını döndürür. Fonksiyon, TimeStamp sistem değişkeni biçiminde değerler döndürür. Varsayılan timer_mode değeri 1'dir.
now([ timer_mode])
Fonksiyon geçerli tarihi döndürür. Fonksiyon, DateFormat sistem değişkeni biçiminde değerler döndürür.
today([timer_mode])
Bu fonksiyon belirli bir saat dilimi için geçerli saatin zaman damgasını döndürür.
localtime([timezone [, ignoreDST ]])
"Make" fonksiyonları
Bu fonksiyon YYYY yılı, MM ayı ve DD gününden hesaplanan bir tarih döndürür.
makedate(YYYY [ , MM [ , DD ] ])
Bu fonksiyon, YYYY yılı, WW haftası ve D hafta gününden hesaplanan bir tarih döndürür.
makeweekdate(YYYY [ , WW [ , D ] ])
Bu fonksiyon hh saati, mm dakikası ve ss saniyesinden hesaplanan bir saat döndürür.
maketime(hh [ , mm [ , ss [ .fff ] ] ])
Diğer tarih fonksiyonları
Fonksiyon, startdate değerinden n ay sonra olan tarihi veya n negatif ise, startdate değerinden n ay önce olan tarihi döndürür.
addmonths(startdate, n , [ , mode])
Fonksiyon, startdate değerinden n yıl sonra olan tarihi veya n negatif ise, startdate değerinden n yıl önce olan tarihi döndürür.
addyears(startdate, n)
Bu fonksiyon giriş zaman damgasının kodun yüklendiği yılda olup olmadığını bulur ve bu yıldaysa True, değilse False değerini döndürür.
yeartodate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Saat dilimi fonksiyonları
Bu fonksiyon, Qlik altyapısının çalıştığı bilgisayarda tanımlı saat dilimini döndürür.
timezone( )
Bu fonksiyon, bölgesel ayarlardan türetildiği haliyle mevcut Greenwich Mean Time değerini döndürür.
GMT( )
Geçerli Coordinated Universal Time değerini döndürür.
UTC( )
Windows'ta tanımlandığı şekilde, günışığından yararlanma saati için geçerli ayarı döndürür.
Bir UTC veya GMT zaman damgasını ikili değer olarak yerel zamana dönüştürür. Yer, dünyadaki bir dizi şehir, yer ve saat diliminden herhangi biri olabilir.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
Zaman ayarlama fonksiyonları
Bu fonksiyon, giriş olarak bir timestamp ve year alır ve timestamp öğesini girişte belirtilen year ile günceller.
setdateyear (timestamp, year)
Bu fonksiyon, giriş olarak bir timestamp, month ve year alır ve timestamp öğesini girişte belirtilen year ve month ile günceller.
setdateyearmonth (timestamp, year, month)
"In..." fonksiyonları
Bu fonksiyon, timestamp değerinin base_date değerini içeren yıl içinde olması halinde True döndürür.
inyear(date, basedate , shift [, first_month_of_year = 1])
Bu fonksiyon, timestamp, yılın base_date öğesinin son milisaniyesine kadar ve bu milisaniye de dahil olmak üzere base_date öğesini içeren bölümünde bulunuyorsa, True sonucunu döndürür.
inyeartodate (date, basedate , shift [, first_month_of_year = 1])
Bu fonksiyon, timestamp değerinin base_date değerini içeren çeyrek içinde olması halinde True döndürür.
inquarter (date, basedate , shift [, first_month_of_year = 1])
Bu fonksiyon, timestamp öğesi çeyreğin base_date öğesinin son milisaniyesine kadar ve bu milisaniye de dahil olmak üzere base_date öğesini içeren bölümünde bulunuyorsa, True sonucunu döndürür.
inquartertodate (date, basedate , shift [, first_month_of_year = 1])
Bu fonksiyon, timestamp değerinin base_date değerini içeren ay içinde olması halinde True döndürür.
inmonth(date, basedate , shift)
date, ayın basedate öğesinin son milisaniyesine kadar ve bu milisaniye de dahil olmak üzere basedate öğesini içeren bölümünde bulunuyorsa, True sonucunu döndürür.
inmonthtodate (date, basedate , shift)
Bu fonksiyon, bir zaman damgasının taban tarih olarak aynı bir aylık, iki aylık, üç aylık, dört aylık veya yarı yıllık dönem içine mi düştüğünü bulur. Zaman damgasının önceki veya sonraki bir zaman dönemine denk gelip gelmediğini bulmak da mümkündür.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
Bu fonksiyon, bir zaman damgasının en son base_date milisaniyesi de daha dahil olmak üzere aylık, iki aylık, üç aylık, dört aylık veya yarı yıllık dönem içine düştüğünü bulur. Zaman damgasının önceki veya sonraki bir zaman dönemine denk gelip gelmediğini bulmak da mümkündür.
inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])
Bu fonksiyon, timestamp değerinin base_date değerini içeren hafta içinde olması halinde True döndürür.
inweek(date, basedate , shift [, weekstart])
Bu fonksiyon, timestamp, haftanın base_date öğesinin son milisaniyesine kadar ve bu milisaniye de dahil olmak üzere base_date öğesini içeren bölümünde bulunuyorsa, True sonucunu döndürür.
inweektodate (date, basedate , shift [, weekstart])
Bu fonksiyon timestamp değerinin base_date değerini içeren ay haftası içinde mi kaldığını belirler. Qlik Sense içinde ay haftaları 1 Ocak haftanın ilk günü olarak sayılarak tanımlanır. Yılın son haftasının dışında her hafta tam olarak yedi gün içerirler.
inlunarweek (date, basedate , shift [, weekstart])
Bu fonksiyon, timestamp'ın ay haftası ile base_date'in son milisaniyesi arasında yer alıp almadığını bulur. Qlik Sense için ay haftaları 1 Ocak haftanın ilk günü olarak tanımlanır ve yılın son haftası dışında tam olarak yedi gün içerirler.
inlunarweektodate (date, basedate , shift [, weekstart])
Bu fonksiyon, timestamp değerinin base_timestamp değerini içeren gün içinde olması halinde True döndürür.
inday(timestamp, basetimestamp , shift [, daystart])
Bu fonksiyon, timestamp öğesi günün base_timestamp öğesinin tam milisaniyesine kadar ve bu milisaniye de dahil olmak üzere base_timestamp öğesini içeren bölümünde bulunuyorsa, True sonucunu döndürür.
indaytotime(timestamp, basetimestamp , shift [, daystart])
"Start ... end" fonksiyonları
Bu fonksiyon, date içeren yılın ilk gününün başlangıcına karşılık gelen bir zaman damgası döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
yearstart( date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, date içeren yılın son gününün son milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
yearend( date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, date öğesini içeren yılın ilk gününün ilk milisaniyesinin zaman damgasına karşılık gelen bir temel sayısal değerle görüntü değeri olarak dört basamaklı bir yıl döndürür.
yearname(date [, shift = 0 [, first_month_of_year = 1]] )
Bu fonksiyon, date içeren çeyreğin ilk milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
quarterstart(date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, date içeren çeyreğin son milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
quarterend(date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, çeyreğin aylarını (MonthNames kod değişkenine göre biçimlendirilmiş) ve yılı, çeyreğin ilk gününün ilk milisaniyesinin zaman damgasına karşılık gelen bir temel sayısal değerle gösteren bir görüntü değeri döndürür.
quartername(date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, date içeren ayın ilk gününün ilk milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
monthstart(date [, shift = 0])
Bu fonksiyon, date içeren ayın son gününün son milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
monthend(date [, shift = 0])
Bu fonksiyon, ayı (MonthNames kod değişkenine göre biçimlendirilmiş) ve yılı, ayın ilk gününün ilk milisaniyesine sahip zaman damgasına karşılık gelen bir temel sayısal değerle gösteren bir görüntü değeri döndürür.
monthname(date [, shift = 0])
Bu fonksiyon, bir taban tarihi içeren aylık, iki aylık, üç aylık, dört aylık veya yarı yıllık dönemin ilk milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Önceki ve sonraki bir zaman dönemi için zaman damgasını bulmak da mümkündür.Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, bir taban tarihi içeren aylık, iki aylık, üç aylık, dört aylık veya yarı yıllık dönemin son milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Önceki ve sonraki bir zaman dönemi için zaman damgasını bulmak da mümkündür.
monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, dönemin ay aralığının (MonthNames kod değişkenine göre biçimlendirilmiş) yanı sıra yılı temsil eden bir görüntü değeri döndürür. Temel alınan sayısal değer bir taban tarihi içeren aylık, iki aylık, üç aylık, dört aylık veya yarı yıllık bir dönemin ilk milisaniyesinin zaman damgasına karşılık gelir.
monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])
Bu fonksiyon, date değerini içeren takvim haftasının ilk gününün (Pazartesi) ilk milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
weekstart(date [, shift = 0 [,weekoffset = 0]])
Bu fonksiyon, date değerini içeren takvim haftasının son gününün (Pazar) son milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan DateFormat olur.
weekend(date [, shift = 0 [,weekoffset = 0]])
Bu fonksiyon, date öğesini içeren haftanın ilk gününün ilk milisaniyesinin zaman damgasına karşılık gelen bir temel sayısal değerle yıl ve hafta sayısını gösteren bir değer döndürür.
weekname(date [, shift = 0 [,weekoffset = 0]])
Bu fonksiyon, date değerini içeren ay haftasının ilk gününün ilk milisaniyesine karşılık gelen bir zaman damgası değeri döndürür. Qlik Sense için ay haftaları 1 Ocak haftanın ilk günü olarak tanımlanır ve yılın son haftası dışında tam olarak yedi gün içerirler.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
Bu fonksiyon, date değerini içeren ay haftasının son gününün son milisaniyesine karşılık gelen bir zaman damgası değeri döndürür. Qlik Sense için ay haftaları 1 Ocak haftanın ilk günü olarak tanımlanır ve yılın son haftası dışında tam olarak yedi gün içerirler.
lunarweekend(date [, shift = 0 [,weekoffset = 0]])
Bu fonksiyon, date içeren ay haftasının ilk gününün ilk milisaniyesinin zaman damgasına karşılık gelen yıl ve ay haftası numarasını gösteren bir görüntü değeri döndürür. Qlik Sense için ay haftaları 1 Ocak haftanın ilk günü olarak tanımlanır ve yılın son haftası dışında tam olarak yedi gün içerirler.
lunarweekname(date [, shift = 0 [,weekoffset = 0]])
Bu fonksiyon, time bağımsız değişkenindeki günün ilk milisaniyesini içeren bir zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan TimestampFormat olur.
daystart(timestamp [, shift = 0 [, dayoffset = 0]])
Bu fonksiyon, time içindeki günün son milisaniyesinin zaman damgasına karşılık gelen bir değer döndürür. Varsayılan çıktı biçimi kodda ayarlanan TimestampFormat olur.
dayend(timestamp [, shift = 0 [, dayoffset = 0]])
Bu fonksiyon, time öğesini içeren günün ilk milisaniyesinin zaman damgasına karşılık gelen bir temel sayısal değerle tarihi gösteren bir değer döndürür.
dayname(timestamp [, shift = 0 [, dayoffset = 0]])
Gün numaralandırma fonksiyonları
age fonksiyonu, date_of_birth tarihinde doğan birinin timestamp sırasındaki yaşını (tamamlanan yıl cinsinden) döndürür.
age(timestamp, date_of_birth)
networkdays fonksiyonu, isteğe bağlı olarak listelenen tüm holiday öğelerini dikkate alarak, start_date ve end_date arasındaki ve bu tarihleri de içeren iş günlerinin (Pazartesi - Cuma) sayısını döndürür.
networkdays (start:date, end_date {, holiday})
firstworkdate fonksiyonu, isteğe bağlı olarak listelenen tüm tatilleri dikkate alarak, end_date tarihinden önce biten no_of_workdays (Pazartesi - Cuma) değerini elde etmek için en son başlangıç tarihini döndürür. end_date ve holiday geçerli tarihler veya zaman damgaları olmalıdır.
firstworkdate(end_date, no_of_workdays {, holiday} )
lastworkdate fonksiyonu, isteğe bağlı holiday varsa bunları da dikkate alarak, start_date ile başlanması halinde no_of_workdays (Pazartesi-Cuma) elde edilmesi için gerekli en erken bitiş tarihini döndürür. start_date ve holiday geçerli tarihler veya zaman damgaları olmalıdır.
lastworkdate(start_date, no_of_workdays {, holiday})
Bu fonksiyon bir zaman damgasının denk geldiği yılın gün numarasını hesaplar. Hesaplama yılın ilk gününün ilk milisaniyesinden itibaren yapılır, ancak ilk ay kaymış olabilir.
daynumberofyear(date[,firstmonth])
Bu fonksiyon bir zaman damgasının denk geldiği çeyreğin gün numarasını hesaplar. Bu fonksiyon Ana Takvim oluşturulurken kullanılır.
daynumberofquarter(date[,firstmonth])