yeartodate - kod ve grafik fonksiyonu

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.

Söz Dizimi:

YearToDate(timestamp[ , yearoffset [ , firstmonth [ , todaydate] ] ])

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

Qlik Sense üzerinde Boolean true değeri -1 ile, false ise 0 ile temsil edilir.

yeartodate fonksiyonunun True veya False değerini döndüreceği tarih değerlerini görüntüleyen diyagram. — yeartodate() fonksiyonunun örnek diyagramı

İsteğe bağlı parametrelerden hiçbiri kullanılmazsa, yıl içinde belirli bir tarihe kadar, 1 Ocak'tan son kod yürütme tarihine kadar ve bu tarihi de içerecek şekilde, bir takvim yılı dahilindeki herhangi bir tarih anlamına gelir.

Diğer bir deyişle, yeartodate() fonksiyonu başka parametre olmadan tetiklendiğinde bir zaman damgasını değerlendirmek için kullanılır ve tarihin, takvim yılı içinde yeniden yüklemenin gerçekleştiği tarihe kadar (bu tarih de dahil olmak üzere) geçen süre içinde kalıp kalmadığına bağlı olarak bir Boole sonucu döndürür.

Bununla birlikte, firstmonth bağımsız değişkenini kullanarak yılın başlangıç tarihini geçersiz kılmak ve yearoffset bağımsız değişkenini kullanarak önceki veya sonraki yıllarla karşılaştırmalar yapmak da mümkündür.

Son olarak, geçmiş veri kümelerinin söz konusu olduğu durumlarda yeartodate() fonksiyonu todaydateayarlamak için bir parametre sağlar ve bu parametre zaman damgasını takvim yılı içinde todaydate bağımsız değişkeninde sağlanan tarihe kadar (bu tarih de dahil olmak üzere) geçen süreyle karşılaştırır.

Bağımsız Değişkenler
Bağımsız Değişken	Açıklama
timestamp	Değerlendirilecek zaman damgası, örneğin '10/12/2012'.
yearoffset	Bir yearoffset belirtilmesiyle, yeartodate başka bir yıldaki aynı dönem için True değerini döndürür. Negatif yearoffset önceki bir yılı belirtirken, pozitif kayma gelecekteki bir yılı belirtir. En yeni year-to-date yearoffset = -1 olarak belirtilmesiyle elde edilir. Atlandığı takdirde 0 olduğu varsayılır.
firstmonth	1 ile 12 arasında bir firstmonth belirtildiğinde (atlandığı takdirde 1) yılın başlangıcı herhangi bir ayın ilk gününe ileri taşınabilir. Örneğin, 1 Mayıs'ta başlayan bir mali yıl ile çalışmak istiyorsanız firstmonth = 5 olarak belirtin. 1 değeri 1 Ocak'ta başlayan mali yılı ve 12 değeri de 1 Aralık'ta başlayan mali yılı göstermektedir.
todaydate	Bir todaydate belirtildiğinde (atlandığı takdirde son kod yürütme işleminin zaman damgası), dönemin üst sınırı olarak kullanılan günü taşımak mümkündür.

Ne zaman kullanılır?

yeartodate() fonksiyonu bir Boole sonucu döndürür. Bu tür fonksiyonlar genellikle bir IF ifadesinde koşul olarak kullanılır. Bu, değerlendirilen tarihin yıl içinde uygulamanın son yeniden yükleme tarihine kadar (bu tarih de dahil olmak üzere) geçen süre içinde yer alıp almadığına bağlı olarak bir toplama veya hesaplama döndürür.

Örneğin, YearToDate() fonksiyonu geçerli yıl içinde şimdiye kadar üretilen tüm ekipmanı belirlemek için kullanılabilir.

Aşağıdaki örneklerde son yeniden yükleme tarihinin 11/18/2011 olduğu varsayılır.

Fonksiyon örnekleri
Örnek	Sonuç
yeartodate( '11/18/2010')	şunu döndürür: False
yeartodate( '02/01/2011')	şunu döndürür: True
yeartodate( '11/18/2011')	şunu döndürür: True
yeartodate( '11/19/2011')	şunu döndürür: False
yeartodate( '11/19/2011', 0, 1, '12/31/2011')	şunu döndürür: True
yeartodate( '11/18/2010', -1)	şunu döndürür: True
yeartodate( '11/18/2011', -1)	şunu döndürür: False
yeartodate( '04/30/2011', 0, 5)	şunu döndürür: False
yeartodate( '05/01/2011', 0, 5)	şunu döndürür: True

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. Uygulamalar ve komut dosyaları için bölgesel ayarları 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. Qlik Cloud Analizleri içinde uygulama ve komut dosyası oluşturmak için tercih ettiğiniz bölgesel ayarları belirleme.

Örnek 1 – Temel örnek

Genel bakış

Veri yükleme düzenleyicisini açın ve aşağıdaki yükleme kodunu yeni bir sekmeye ekleyin.

Yükleme kodu şunları içerir:

Transactions adlı tabloya yüklenen, 2020 ile 2022 arasında yapılmış işlemler içeren bir veri kümesi.
Tarih alanı DateFormat sistem değişkeninde (AA/GG/YYYY) biçiminde sağlanmıştır.
Hangi işlemlerin takvim yılı içinde son yeniden yükleme tarihine kadar gerçekleştiğini belirlemek için year_to_date alanını oluşturma.

Bu yazıldığı sırada tarih 26 Nisan 2022'dir.

Komut dosyası

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        yeartodate(date) as year_to_date
        ;
Load
*
Inline 
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];

Sonuçlar

Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanları boyut olarak ekleyin:

date
year_to_date

Sonuçlar tablosu
date	year_to_date
01/10/2020	0
02/28/2020	0
04/09/2020	0
04/16/2020	0
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	0
12/27/2021	0
02/02/2022	-1
02/26/2022	-1
03/07/2022	-1
03/11/2022	-1

year_to_date alanı, önceki yükleme deyiminde yeartodate() fonksiyonu kullanılarak ve date alanı fonksiyona bağımsız değişken olarak geçilerek oluşturulur.

Fonksiyona başka parametre geçirilmediğinden, yeartodate() fonksiyonu önce yeniden yükleme tarihini ve dolayısıyla geçerli takvim yılı (1 Ocak'tan başlayarak) için TRUE Boole sonucunu döndürecek sınırları belirler.

Bu nedenle, 1 Ocak ile yeniden yükleme tarihi olan 26 Nisan arasında gerçekleşen tüm işlemler TRUE Boole sonucunu döndürür. 2022'nin başlangıcından önce gerçekleşen tüm işlemler FALSE Boole sonucunu döndürür.

Örnek 2 – yearoffset

Genel bakış

Veri yükleme düzenleyicisini açın ve aşağıdaki yükleme kodunu yeni bir sekmeye ekleyin.

Yükleme kodu şunları içerir:

İlk örnek ile aynı veri kümesi ve senaryo.
Yıl başından bugüne kadar olan süreden iki tam yıl önce hangi işlemlerin gerçekleştiğini belirlemek için two_years_prior alanını oluşturma.

Komut dosyası

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        yeartodate(date,-2) as two_years_prior
        ;
Load
*
Inline 
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];

Sonuçlar

Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanları boyut olarak ekleyin:

date
two_years_prior

Sonuçlar tablosu
date	two_years_prior
01/10/2020	-1
02/28/2020	-1
04/09/2020	-1
04/16/2020	-1
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	0
12/27/2021	0
02/02/2022	0
02/26/2022	0
03/07/2022	0
03/11/2022	0

yeartodate() fonksiyonunda yearoffset bağımsız değişkeni olarak -2 kullanıldığında, fonksiyon karşılaştırıcı takvim yılı segmentinin sınırlarını tam iki yıl kaydırır. Başlangıçta yıl segmenti 1 Ocak ile 26 Nisan 2022 arasına eşittir. Sonra yearoffset bağımsız değişkeni bu segmenti iki yıl öncesine taşır. Bundan sonra tarih sınırları 1 Ocak ile 26 Aralık 2020 arasında olacaktır.

Dolayısıyla 1 Ocak ile 26 Nisan 2020 arasında gerçekleşen tüm işlemler TRUE Boole sonucunu döndürür. Bu segmentin öncesinde veya sonrasında görünen tüm işlemler FALSE döndürür.

Örnek 3 – firstmonth

Genel bakış

Veri yükleme düzenleyicisini açın ve aşağıdaki yükleme kodunu yeni bir sekmeye ekleyin.

Yükleme kodu şunları içerir:

İlk örnek ile aynı veri kümesi ve senaryo.
Hangi işlemlerin takvim yılı içinde son yeniden yükleme tarihine kadar gerçekleştiğini belirlemek için year_to_date alanını oluşturma.

Bu örnekte mali yılın başlangıcını 1 Temmuz olarak ayarladık.

Komut dosyası

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        yeartodate(date,0,7) as year_to_date
        ;
Load
*
Inline 
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];

Sonuçlar

Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanları boyut olarak ekleyin:

date
year_to_date

Sonuçlar tablosu
date	year_to_date
01/10/2020	0
02/28/2020	0
04/09/2020	0
04/16/2020	0
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	-1
12/27/2021	-1
02/02/2022	-1
02/26/2022	-1
03/07/2022	-1
03/11/2022	-1

Bu örnekte, yeartodate() fonksiyonunda firstmonth bağımsız değişkeni olarak 7 kullanıldığından yılın ilk günü 1 Temmuz ve son günü de 30 Haziran olarak ayarlanır.

Dolayısıyla 1 Temmuz 2021 ile yeniden yükleme tarihi olan 26 Nisan 2022 arasında gerçekleşen tüm işlemler TRUE Boole sonucunu döndürür. 1 Temmuz 2021'den önce gerçekleşen tüm işlemler FALSE Boole sonucunu döndürür.

Örnek 4 – todaydate

Genel bakış

Veri yükleme düzenleyicisini açın ve aşağıdaki yükleme kodunu yeni bir sekmeye ekleyin.

Yükleme kodu şunları içerir:

İlk örnek ile aynı veri kümesi ve senaryo.
Hangi işlemlerin takvim yılı içinde son yeniden yükleme tarihine kadar gerçekleştiğini belirlemek için year_to_date alanını oluşturma.

Öte yandan bu örnekte, takvim yılında 1 Mart 2022'ye kadar (bu tarih de dahil olmak üzere) gerçekleşen tüm işlemleri belirlememiz gerekmektedir.

Komut dosyası

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        yeartodate(date, 0, 1, '03/01/2022') as year_to_date
;
Load
*
Inline 
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];

Sonuçlar

Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanları boyut olarak ekleyin:

date
year_to_date

Sonuçlar tablosu
date	year_to_date
01/10/2020	0
02/28/2020	0
04/09/2020	0
04/16/2020	0
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	0
12/27/2021	0
02/02/2022	-1
02/26/2022	-1
03/07/2022	0
03/11/2022	0

Bu örnekte, yeartodate() fonksiyonunda todaydate bağımsız değişkeni olarak 03/01/2022 kullanıldığından, karşılaştırıcı takvim yılı segmentinin son sınırı 1 Mart 2022 olarak ayarlanır. firstmonth parametresini sağlamak çok önemlidir (1 ile 12 arasında); aksi takdirde fonksiyon null sonuçlar döndürür.

Dolayısıyla 1 Ocak 2022 ile todaydate parametresinin değeri olan 1 Mart 2022 arasında gerçekleşen tüm işlemler TRUE Boole sonucunu döndürür. 1 Ocak 2022'den önce veya 1 Mart 2022'den sonra gerçekleşen tüm işlemler FALSE Boole sonucunu döndürür.

Örnek 5 – Grafik nesnesi örneği

Genel bakış

Veri yükleme düzenleyicisini açın ve aşağıdaki komut dosyasını yeni bir sekmeye ekleyin.

Komut dosyası ilk örnek ile aynı veri kümesini ve senaryoyu içerir.

Ancak bu örnekte uygulamaya değiştirilmemiş veri kümesi yüklenmektedir. Takvim yılında son yeniden yükleme tarihine kadar hangi işlemlerin gerçekleştiğini belirleyen hesaplama, uygulamanın grafik nesnesinde bir hesaplama olarak oluşturulur.

Komut dosyası

Transactions:
Load
*
Inline 
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];

Sonuçlar

Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanı boyut olarak ekleyin: date.

Aşağıdaki hesaplamayı ekleyin:

=yeartodate(date)

Sonuçlar tablosu
date	=yeartodate(date)
01/10/2020	0
02/28/2020	0
04/09/2020	0
04/16/2020	0
05/21/2020	0
08/14/2020	0
10/07/2020	0
12/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	0
12/27/2021	0
02/02/2022	-1
02/26/2022	-1
03/07/2022	-1
03/11/2022	-1

year_to_date hesaplaması, grafik nesnesinde yeartodate() fonksiyonu kullanılarak ve date alanı fonksiyonun bağımsız değişkeni olarak geçilerek oluşturulur.

1 Ocak ile yeniden yükleme tarihi olan 26 Nisan arasında gerçekleşen tüm işlemler TRUE Boole sonucunu döndürür. 2022'nin başlangıcından önce gerçekleşen tüm işlemler FALSE Boole sonucunu döndürür.

Örnek 6 – Senaryo

Genel bakış

Veri yükleme düzenleyicisini açın ve aşağıdaki yükleme kodunu yeni bir sekmeye ekleyin.

Yükleme kodu şunları içerir:

Transactions adlı tabloya yüklenen, 2020 ile 2022 arasında yapılmış işlemler içeren bir veri kümesi.
Tarih alanı DateFormat sistem değişkeninde (AA/GG/YYYY) biçiminde sağlanmıştır.

Son kullanıcı, 2021'in yıl başından son yeniden yükleme zamanına kadar olan süreyle eşdeğer dönemi için toplam satışları gösteren bir KPI nesnesi istemektedir.

Bu yazıldığı sırada tarih 16 Haziran 2022'dir.

Komut dosyası

SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline 
[
id,date,amount
8188,01/10/2020,37.23
8189,02/28/2020,17.17
8190,04/09/2020,88.27
8191,04/16/2020,57.42
8192,05/21/2020,53.80
8193,08/14/2020,82.06
8194,10/07/2020,40.39
8195,12/05/2020,87.21
8196,01/22/2021,95.93
8197,02/03/2021,45.89
8198,03/17/2021,36.23
8199,04/23/2021,25.66
8200,05/04/2021,82.77
8201,06/30/2021,69.98
8202,07/26/2021,76.11
8203,12/27/2021,25.12
8204,02/02/2022,46.23
8205,02/26/2022,84.21
8206,03/07/2022,96.24
8207,03/11/2022,67.67
];

Sonuçlar

Aşağıdakileri yapın:

Bir KPI nesnesi oluşturun.
Toplam satışları hesaplamak için aşağıdaki toplamayı oluşturun:

=sum(if(yeartodate(date,-1),amount,0))
Hesaplamanın Sayı Biçimini Para olarak ayarlayın.

yeartodate fonksiyonu kullanılarak oluşturulan ve 2021'in satış verilerini temsil eden KPI görselleştirmesi. — 2021 için KPI yeartodate() grafiği

yeartodate() fonksiyonu her işlem kimliğinin tarihlerini değerlendirir ve bir Boole değeri döndürür. Yeniden yükleme 16 Haziran 2022'de gerçekleştiğinden, yeartodate fonksiyonu 01/01/2022 ile 06/16/2022 arasındaki yıl dönemini segmentlere ayırır. Öte yandan fonksiyonda period_no değeri olarak -1 kullanıldığından, bu sınırlar önceki yıla kaydırılır. Dolayısıyla yeartodate() fonksiyonu 01/01/2021 ile 06/16/2021 arasında gerçekleşen tüm işlemler TRUE Boole değerini döndürür ve tutarı toplar.

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız, bize bildirin, düzeltelim!

Geri bildiriminizi buradan iletin