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.
Söz Dizimi:
AddMonths(startdate, n
, [ , mode])
Dönüş verileri türü: dual
addmonths() fonksiyonu, tanımlı ay sayısı olan n değerini startdate değeriyle toplar veya bundan çıkarır ve sonuçta elde edilen tarihi döndürür.
mode bağımsız değişkeni ayın 28'inde ve sonrasındaki startdate değerlerini etkiler. mode bağımsız değişkeni 1 olarak ayarlandığında addmonths() fonksiyonu startdate olarak ayın sonuna olan göreli uzaklığa eşit bir tarih döndürür.
Örneğin 28 Şubat ayın son günüdür. İki ay sonrasının tarihini döndürmek için mode değeri 1 olan addmonths() fonksiyonu kullanılırsa, fonksiyon Nisan ayının son günü olan 30 Nisan tarihini döndürür.
Bağımsız Değişkenler
Bağımsız Değişken
Açıklama
startdate
Bir zaman damgası olarak başlangıç tarihi; örneğin '2012-10-12'.
n
Pozitif veya negatif tamsayı olarak ay sayısı.
mode
Ayın başına göre mi, yoksa sonuna göre mi ay eklendiğini belirtir. Varsayılan mod, ayın başına göre eklemeler için 0 olur. Ayın sonuna göre eklemeler için modu 1 olarak ayarlayın. Mod 1 olarak ayarlandığında ve giriş tarihi 28 veya daha sonraki bir tarih olduğunda fonksiyon, başlangıç tarihinde ayın sonuna ulaşmak için kaç gün kaldığını denetler. Döndürülen tarihte, ayın sonuna ulaşmak için aynı gün sayısı ayarlanır.
Ne zaman kullanılır?
Bir ifadede addmonths() fonksiyonu yaygın olarak, bir zaman aralığından belirli sayıda ay kadar önceki veya sonraki tarihi bulmak için kullanılır.
Örneğin addmonths() fonksiyonu cep telefonu sözleşmelerinin son tarihini belirlemek için kullanılabilir.
Fonksiyon örnekleri
Örnek
Sonuç
addmonths ('01/29/2003' ,3)
"04/29/2003" döndürür.
addmonths ('01/29/2003',3,0)
"04/29/2003" döndürür.
addmonths ('01/29/2003',3,1)
"04/28/2003" döndürür.
addmonths ('01/29/2003',1,0)
"02/28/2003" döndürür.
addmonths ('01/29/2003',1,1)
"02/26/2003" döndürür.
addmonths ('02/28/2003',1,0)
"03/28/2003" döndürür.
addmonths ('02/28/2003',1,1)
"03/31/2003" döndürür.
addmonths ('01/29/2003',-3)
"10/29/2002" 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.
Uygulamalardaki bölgesel ayarlarda Qlik Sense'in yüklü olduğu bilgisayarın veya sunucunun bölgesel sistem ayarları temel alınır. Eriştiğiniz Qlik Sense sunucusu İsveç olarak ayarlıysa, Veri yükleme düzenleyicisi tarihler, saat ve para birimi için İsveç bölgesel ayarlarını kullanır. Bu bölgesel format ayarları, Qlik Sense kullanıcı arayüzünde görüntülenen dil ayarlarıyla ilgili değildir. Qlik Sense, kullandığınız tarayıcıyla aynı dilde görüntülenir.
Örnek 1 – Ek bağımsız değişken yok
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.
İşlemin gerçekleşmesinden iki ay sonraki tarihi döndüren two_months_later alanını oluşturma.
Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanları boyut olarak ekleyin:
date
two_months_later
Sonuçlar tablosu
date
two_months_later
01/10/2020
03/10/2020
02/28/2020
04/28/2020
04/09/2020
06/09/2020
04/16/2020
06/16/2020
05/21/2020
07/21/2020
08/14/2020
10/14/2020
10/07/2020
12/07/2020
12/05/2020
02/05/2021
01/22/2021
03/22/2021
02/03/2021
04/03/2021
03/17/2021
05/17/2021
04/23/2021
06/23/2021
05/04/2021
07/04/2021
06/30/2021
08/30/2021
07/26/2021
09/26/2021
12/27/2021
02/27/2022
02/02/2022
04/02/2022
02/26/2022
04/26/2022
03/07/2022
05/07/2022
03/11/2022
05/11/2022
two_months_later alanı, öncelikli yükleme deyiminde addmonths() fonksiyonu kullanılarak oluşturulur. Sağlanan ilk bağımsız değişken hangi tarihin değerlendirilmekte olduğunu belirler. İkinci bağımsız değişken startdate tarihiyle toplanacak veya bu tarihten çıkarılacak ay sayısıdır. Bu örnekte 2 değeri sağlanmıştır.
8193 numaralı İşlem 14 Ağustos'ta gerçekleşmiştir. Bu nedenle addmonths() fonksiyonu two_months_later alanı için 14 Ekim 2020 tarihini döndürür.
Örnek 2 – Göreli ay sonu
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:
2022'nin Transactions adlı tabloya yüklenen bir dizi ay sonu işleminin yer aldığı veri kümesi.
Tarih alanı DateFormat sistem değişkeninde (AA/GG/YYYY) biçiminde sağlanmıştır.
İşlemin gerçekleşmesinden iki ay öncesi için göreli ay sonu tarihini döndüren relative_two_months_prior alanını oluşturma.
Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanları boyut olarak ekleyin:
date
relative_two_months_prior
Sonuçlar tablosu
date
relative_two_months_prior
01/28/2022
11/27/2021
01/31/2022
11/30/2021
02/28/2022
12/31/2021
04/29/2022
02/27/2022
04/30/2022
02/28/2022
05/31/2022
03/31/2022
08/14/2022
06/14/2022
10/07/2022
08/07/2022
relative_two_months_prior alanı, önceki Load deyiminde addmonths() fonksiyonu kullanılarak oluşturulur. Sağlanan ilk bağımsız değişken hangi tarihin değerlendirilmekte olduğunu belirler. İkinci bağımsız değişken startdate tarihiyle toplanacak veya bu tarihten çıkarılacak ay sayısıdır. Bu örnekte -2 değeri sağlanmıştır. Son bağımsız değişken, değeri 1 olan ve fonksiyonu 28'den büyük veya buna eşit tüm tarihler için göreli ay sonu tarihini hesaplamaya zorlayan mode bağımsız değişkenidir.
8191 numaralı İşlem 29 Nisan 2022'de gerçekleşir. Başlangıçta, iki ay öncesi, ayı Şubat olarak ayarlayabilir. Ardından, fonksiyonda modu 1 değerine ayarlayan üçüncü bağımsız değişken nedeniyle ve gün değeri ayın 27'sinden sonraki bir gün olduğundan, fonksiyon göreli ay sonu değerini hesaplar. Fonksiyon, ayın 29'unun Nisan'ın sondan bir önceki günü olduğunu belirler ve Şubat'ın sondan bir önceki gününü (ayın 27'sini) döndürür.
Örnek 3 – 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. İşlemin gerçekleşmesinden iki ay sonrasının tarihini döndüren hesaplama, grafik nesnesinde bir hesaplama olarak oluşturulur.
Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun ve şu alanı boyut olarak ekleyin: date.
Şu hesaplamayı oluşturun:
=addmonths(date,2)
Sonuçlar tablosu
date
=addmonths(date,2)
01/10/2020
03/10/2020
02/28/2020
04/28/2020
04/09/2020
06/09/2020
04/16/2020
06/16/2020
05/21/2020
07/21/2020
08/14/2020
10/14/2020
10/07/2020
12/07/2020
12/05/2020
02/05/2021
01/22/2021
03/22/2021
02/03/2021
04/03/2021
03/17/2021
05/17/2021
04/23/2021
06/23/2021
05/04/2021
07/04/2021
06/30/2021
08/30/2021
07/26/2021
09/26/2021
12/27/2021
02/27/2022
02/02/2022
04/02/2022
02/26/2022
04/26/2022
03/07/2022
05/07/2022
03/11/2022
05/11/2022
Grafik nesnesinde addmonths() fonksiyonu kullanılarak two_months_later hesaplaması oluşturulur. Sağlanan ilk bağımsız değişken hangi tarihin değerlendirilmekte olduğunu belirler. İkinci bağımsız değişken startdate tarihiyle toplanacak veya bu tarihten çıkarılacak ay sayısıdır. Bu örnekte 2 değeri sağlanmıştır.
8193 numaralı İşlem 14 Ağustos'ta gerçekleşmiştir. Bu nedenle addmonths() fonksiyonu two_months_later alanı için 14 Ekim 2020 tarihini döndürür.
Örnek 4 – 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:
Mobile_Plans adlı tabloya yüklenen bir veri kümesi.
Sözleşme kimliği, başlangıç tarihi, sözleşme uzunluğu ve aylık ücret bilgileri.
Son kullanıcı, sözleşme kimliğine göre her telefon sözleşmesinin sonlandırma tarihini görüntüleyen bir grafik nesnesi istemektedir.