Ana içeriğe geç

weekstart - kod ve grafik fonksiyonu

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.

Söz Dizimi:  

WeekStart(timestamp [, period_no [, first_week_day ]])

Dönüş verileri türü: dual

weekstart() fonksiyonu tarihin hangi haftanın içinde bulunduğunu belirler. Ardından söz konusu haftanın ilk milisaniyesi için tarih biçiminde bir zaman damgası döndürür. Haftanın ilk günü FirstWeekDay ortam değişkeni tarafından belirlenir. Ancak bu, weekstart() fonksiyonundaki first_week_day bağımsız değişkeni tarafından geçersiz kılınabilir.

Bağımsız Değişkenler
Bağımsız Değişken Açıklama
timestamp Değerlendirilecek tarih veya zaman damgası.
period_no shift bir tamsayı olup, burada 0 değeri date içeren haftayı belirtir. Shift içindeki negatif değerler önceki haftaları; pozitif değerler ise sonraki haftaları gösterir.
first_week_day

Haftanın başladığı günü belirtir. Atlandığı takdirde, FirstWeekDay değişkeninin değeri kullanılır.

Olabilecek first_week_day değerleri Pazartesi için 0, Salı için 1, Çarşamba için 2, Perşembe için 3, Cuma için 4, Cumartesi için 5 ve Pazar için 6'dır.

Sistem değişkeni hakkında daha fazla bilgi için bkz. FirstWeekDay.

Ne zaman kullanılır?

Genel olarak weekstart() fonksiyonu, kullanıcının hesaplamada haftanın şu ana kadar geçen kısmını kullanmak istemesi durumunda, ifadenin içinde kullanılır. Örneğin, kullanıcı haftanın şu ana kadar geçen süresinde kazanılan toplam ücreti hesaplamak istediğinde kullanılabilir.

Aşağıdaki örneklerde varsayılanlar:

SET FirstWeekDay=0;
Fonksiyon örnekleri
Örnek Sonuç
weekstart('01/12/2013') 01/07/2013 döndürür.
weekstart('01/12/2013', -1 ) 11/31/2012 döndürür.
weekstart('01/12/2013', 0, 1) 01/08/2013 döndürür.

Bölgesel ayarlar

Aksi belirtilmedikçe bu konudaki örneklerde aşağıdaki tarih formatı kullanılır: AA/GG/YYYY. Tarih formatı, veri yükleme kodunuzda SET DateFormat deyiminde belirtilir. Varsayılan tarih formatı, bölgesel ayarlarınız ve diğer unsurlar nedeniyle sisteminizde farklı olabilir. Aşağıdaki örneklerdeki formatları ihtiyaçlarınıza uyacak şekilde değiştirebilirsiniz. Dilerseniz yükleme kodunuzdaki formatları aşağıdaki örneklere uyacak şekilde değiştirebilirsiniz. Daha fazla bilgi için bkz. Uygulama bölge ayarlarını değiştirme.

Uygulamalardaki varsayılan bölgesel ayarlarda kullanıcı profili temel alınır. Bu bölgesel format ayarları, Qlik Cloud kullanıcı arayüzünde görüntülenen dil ayarlarıyla ilgili değildir. Qlik Cloud, kullandığınız tarayıcıyla aynı dilde görüntülenir.

Bir uygulama oluşturucuysanız, oluşturduğunuz uygulamanın varsayılan bölgesini ayarlayabilirsiniz. Daha fazla bilgi için bkz. Uygulama oluşturmak için tercih ettiğiniz bölgesel ayarları belirleme.

Örnekler:  

Haftalar ve hafta numaraları için ISO ayarlarını istiyorsanız, şu komut dosyasına sahip olduğunuzdan emin olun:

Set DateFormat ='YYYY-MM-DD'; Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; //(use unbroken weeks) Set ReferenceDay =4; // Jan 4th is always in week 1

ABD ayarlarını istiyorsanız, kodda şunlara sahip olduğunuzdan emin olun:

Set DateFormat ='M/D/YYYY'; Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; //(use broken weeks) Set ReferenceDay =1; // Jan 1st is always in week 1

Yukarıdaki örnekler weekstart() fonksiyonundan şu sonuçları verir:

Weekstart fonksiyonu örneği
Tarih ISO hafta başı ABD hafta başı
26 Aralık 2020 Cumartesi 2020-12-21 12/20/2020
27 Aralık 2020 Pazar 2020-12-21 12/27/2020
28 Aralık 2020 Pazartesi 2020-12-28 12/27/2020
29 Aralık 2020 Salı 2020-12-28 12/27/2020
30 Aralık 2020 Çarşamba 2020-12-28 12/27/2020
31 Aralık 2020 Perşembe 2020-12-28 12/27/2020
1 Ocak 2021 Cuma 2020-12-28 12/27/2020
2 Ocak 2021 Cumartesi 2020-12-28 12/27/2020
3 Ocak 2021 Pazar 2020-12-28 1/3/2021
4 Ocak 2021 Pazartesi 2021-01-04 1/3/2021
5 Ocak 2021 Salı 2021-01-04 1/3/2021
Bilgi notuHafta ISO sütununda Pazartesi günü, ABD sütununda ise Pazar günü başlar.

Örnek 1 – Ek bağımsız değişken yok

Örnek 2 – period_no

Örnek 3 – first_week_day

Örnek 4 – Grafik nesnesi örneği

Örnek 5 – Senaryo