# quartername - kod ve grafik fonksiyonu

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.

Söz Dizimi:

QuarterName(date[, period\_no[, first\_month\_of\_year]])

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

`quartername()` fonksiyonu diyagramı

`quartername()` fonksiyonu diyagramı

`quartername()`quartername() fonksiyonu diyagramı ![quartername fonksiyonunun bir giriş tarihini, tarihin içinde bulunduğu çeyrekteki ay aralığına nasıl dönüştürdüğünü gösteren örnek diyagram.](https://help.qlik.com/tr-TR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-general.png)

`quartername()` fonksiyonu tarihin hangi çeyreğin içinde bulunduğunu belirler. Ardından hem bu çeyreğin başlangıç-bitiş aylarını hem de yılını gösteren bir değer döndürür. Bu sonucun temel sayısal değeri, çeyreğin ilk milisaniyesidir.

Bağımsız Değişkenler

| Bağımsız Değişken | Açıklama |
| --- | --- |
| date | Değerlendirilecek tarih veya zaman damgası. |
| period\_no | period\_no bir tamsayı olup, burada 0 değeri date içeren çeyreği belirtir. period\_no içindeki negatif değerler önceki çeyrekleri; pozitif değerler ise sonraki çeyrekleri gösterir. |
| first\_month\_of\_year | Ocak'ta başlamayan (mali) yıllarla çalışmak istiyorsanız, first\_month\_of\_year içinde 2 ile 12 arasında bir değer belirtin. |

## Ne zaman kullanılır?

`quartername()` fonksiyonu, çeyreğe göre toplamaları karşılaştırmak istediğinizde yararlı olur. Örneğin çeyreğe göre ürünlerin toplam satışlarını görmek isteyebilirsiniz.

Bu fonksiyon komut dosyasında kullanılarak Ana Takvim tablosunda bir alan oluşturulabilir. Alternatif olarak, doğrudan grafiğin içinde hesaplanan boyut olarak da kullanılabilir.

Bu örnekler AA/GG/YYYY tarih biçimini kullanır. Tarih biçimi, veri yükleme komut dosyanızın en üstündeki `SET DateFormat` deyiminde belirtilir. Örneklerdeki biçimi gereksinimlerinize uyacak şekilde değiştirin.

Fonksiyon örnekleri

| Örnek | Sonuç |
| --- | --- |
| `quartername('10/29/2013')` | Oct-Dec 2013 döndürür. |
| `quartername('10/29/2013', -1)` | Jul-Sep 2013 döndürür. |
| `quartername('10/29/2013', 0, 3)` | Sep-Nov 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.

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 olmadan tarih

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Komut dosyası ve sonuçlar

Genel bakış

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

Komut dosyası şunları içerir:

* "`Transactions`" adlı tabloya yüklenen, 2022'nin işlemlerini içeren bir veri kümesi.

* Tarih alanı `DateFormat` sistem değişkeninde (AA/GG/YYYY) biçiminde sağlanmıştır.

* İşlemlerin gerçekleştiği çeyreği döndüren `transaction_quarter` alanını oluşturma.

Gerekirse diğer metninizi, listeler vb. ile buraya ekleyin.

Komut dosyası

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/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`

* `transaction_quarter`

Sonuçlar tablosu

| tarih | transaction\_quarter |
| --- | --- |
| 1/7/2022 | Oca-Mar 2022 |
| 1/19/2022 | Oca-Mar 2022 |
| 2/5/2022 | Oca-Mar 2022 |
| 2/28/2022 | Oca-Mar 2022 |
| 3/16/2022 | Oca-Mar 2022 |
| 4/1/2022 | Nis-Haz 2022 |
| 5/7/2022 | Nis-Haz 2022 |
| 5/16/2022 | Nis-Haz 2022 |
| 6/15/2022 | Nis-Haz 2022 |
| 6/26/2022 | Nis-Haz 2022 |
| 7/9/2022 | Tem-Eyl 2022 |
| 7/22/2022 | Tem-Eyl 2022 |
| 7/23/2022 | Tem-Eyl 2022 |
| 7/27/2022 | Tem-Eyl 2022 |
| 8/2/2022 | Tem-Eyl 2022 |
| 8/8/2022 | Tem-Eyl 2022 |
| 8/19/2022 | Tem-Eyl 2022 |
| 9/26/2022 | Tem-Eyl 2022 |
| 10/14/2022 | Eki-Ara 2022 |
| 10/29/2022 | Eki-Ara 2022 |

"`transaction_quarter`" alanı, önceki Load deyiminde `quartername()` fonksiyonu kullanılarak ve tarih alanı fonksiyonun bağımsız değişkeni olarak geçilerek oluşturulur.

`quartername()` fonksiyonu önce tarih değerinin içinde bulunduğu çeyreği belirler. Ardından hem bu çeyreğin başlangıç-bitiş aylarını hem de yılını gösteren bir değer döndürür.

Ek bağımsız değişkeni olmayan örnek `quartername()` fonksiyonu diyagramı

Ek bağımsız değişkeni olmayan örnek `quartername()` fonksiyonu diyagramı

Ek bağımsız değişkeni olmayan örnek `quartername()`quartername() fonksiyonu diyagramı![quartername fonksiyonunun işlemin gerçekleştiği çeyreğin ay aralığını nasıl belirlediğini gösteren diyagram.](https://help.qlik.com/tr-TR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-no-add-arg.png)

8203 numaralı işlem 8 Ağustos 2022'de gerçekleşmiştir. `quartername()` fonksiyonu işlemin üçüncü çeyrekte gerçekleştiğini belirler ve bu nedenle Tem-Eyl 2022 döndürür. Aylar, `MonthNames` sistem değişkeniyle aynı biçimde görüntülenir.

## Örnek 2 – period\_no bağımsız değişkeniyle tarih

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Komut dosyası ve sonuçlar

Genel bakış

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

Komut dosyası şunları içerir:

* İlk örnek ile aynı veri kümesi ve senaryo.

* İşlemin gerçekleştiği çeyrekten önceki çeyreği döndüren `previous_quarter` alanını oluşturma.

Komut dosyası

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,-1) as previous_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/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`

* `previous_quarter`

Sonuçlar tablosu

| tarih | previous\_quarter |
| --- | --- |
| 1/7/2022 | Eki-Ara 2021 |
| 1/19/2022 | Eki-Ara 2021 |
| 2/5/2022 | Eki-Ara 2021 |
| 2/28/2022 | Eki-Ara 2021 |
| 3/16/2022 | Eki-Ara 2021 |
| 4/1/2022 | Oca-Mar 2022 |
| 5/7/2022 | Oca-Mar 2022 |
| 5/16/2022 | Oca-Mar 2022 |
| 6/15/2022 | Oca-Mar 2022 |
| 6/26/2022 | Oca-Mar 2022 |
| 7/9/2022 | Nis-Haz 2022 |
| 7/22/2022 | Nis-Haz 2022 |
| 7/23/2022 | Nis-Haz 2022 |
| 7/27/2022 | Nis-Haz 2022 |
| 8/2/2022 | Nis-Haz 2022 |
| 8/8/2022 | Nis-Haz 2022 |
| 8/19/2022 | Nis-Haz 2022 |
| 9/26/2022 | Nis-Haz 2022 |
| 10/14/2022 | Tem-Eyl 2022 |
| 10/29/2022 | Tem-Eyl 2022 |

Bu örnekte `quartername()` fonksiyonunda offset bağımsız değişkeni olarak değeri -1 olan `period_no` kullanıldığından, fonksiyon önce işlemlerin üçüncü çeyrekte gerçekleştiğini belirler. Ardından bir önceki çeyreğe geçer ve hem bu çeyreğin başlangıç-bitiş aylarını hem de yılını gösteren bir değer döndürür.

`quartername()` fonksiyonu diyagramı, period\_no örneği

`quartername()` fonksiyonu diyagramı, period\_no örneği

`quartername()`quartername() fonksiyonu diyagramı, period\_no örneği![quartername fonksiyonunun işlemin gerçekleştiği çeyreğin ay aralığını nasıl belirlediğini gösteren diyagram.](https://help.qlik.com/tr-TR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-period-no.png)

8203 numaralı işlem 8 Ağustos'ta gerçekleşmiştir. `quartername()` fonksiyonu işlemin gerçekleşmesinden önceki çeyreğin 1 Nisan ile 30 Haziran arası olduğunu belirler. Bu nedenle Nis-Haz 2022 değerini döndürür.

## Örnek 3 – first\_week\_day bağımsız değişkeniyle tarih

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Komut dosyası ve sonuçlar

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. Öte yandan bu örnekte, mali yılın başlangıcını 1 Mart olarak ayarlamamız gerekir.

Komut dosyası

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        quartername(date,0,3) as transaction_quarter
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/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`

* `transaction_quarter`

Sonuçlar tablosu

| tarih | transaction\_quarter |
| --- | --- |
| 1/7/2022 | Ara-Şub 2021 |
| 1/19/2022 | Ara-Şub 2021 |
| 2/5/2022 | Ara-Şub 2021 |
| 2/28/2022 | Ara-Şub 2021 |
| 3/16/2022 | Mar-May 2022 |
| 4/1/2022 | Mar-May 2022 |
| 5/7/2022 | Mar-May 2022 |
| 5/16/2022 | Mar-May 2022 |
| 6/15/2022 | Haz-Ağu 2022 |
| 6/26/2022 | Haz-Ağu 2022 |
| 7/9/2022 | Haz-Ağu 2022 |
| 7/22/2022 | Haz-Ağu 2022 |
| 7/23/2022 | Haz-Ağu 2022 |
| 7/27/2022 | Haz-Ağu 2022 |
| 8/2/2022 | Haz-Ağu 2022 |
| 8/8/2022 | Haz-Ağu 2022 |
| 8/19/2022 | Haz-Ağu 2022 |
| 9/26/2022 | Eyl-Kas 2022 |
| 10/14/2022 | Eyl-Kas 2022 |
| 10/29/2022 | Eyl-Kas 2022 |

Bu örnekte, `quartername()` fonksiyonunda `first_month_of_year` bağımsız değişkeni olarak 3 kullanıldığından, yılın başlangıcı 1 Ocak'tan 1 Mart'a kaydırılır. Bu nedenle yılın çeyrekleri Mart-Mayıs, Haziran-Ağustos, Eylül-Kasım ve Aralık-Şubat olarak ayrılır.

`quartername()` fonksiyonu diyagramı, first\_week\_day örneği

`quartername()` fonksiyonu diyagramı, first\_week\_day örneği

`quartername()`quartername() fonksiyonu diyagramı, first\_week\_day örneği![quartername fonksiyonunun işlemin gerçekleştiği çeyreğin ay aralığını nasıl belirlediğini gösteren diyagram.](https://help.qlik.com/tr-TR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-first-week-day.png)

8203 numaralı işlem 8 Ağustos'ta gerçekleşmiştir. `quartername()` fonksiyonu işlemin Haziran'ın başı ile Ağustos'un sonu arasındaki ikinci çeyrekte gerçekleştiğini belirler. Bu nedenle Haz-Ağu 2022 değerini döndürür.

## Örnek 4 – Grafik nesnesi örneği

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Komut dosyası ve grafik ifadesi

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ştiği çeyreğin sonu için zaman damgasını döndüren hesaplama, uygulamanın grafik nesnesinde bir hesaplama olarak oluşturulur.

Komut dosyası

```
Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/022,84.21
8206,10/14/2022,96.24
8207,10/29/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.

Şu hesaplamayı oluşturun:

=quartername(date)

Sonuçlar tablosu

| tarih | =quartername(date) |
| --- | --- |
| 1/7/2022 | Oca-Mar 2022 |
| 1/19/2022 | Oca-Mar 2022 |
| 2/5/2022 | Oca-Mar 2022 |
| 2/28/2022 | Oca-Mar 2022 |
| 3/16/2022 | Oca-Mar 2022 |
| 4/1/2022 | Nis-Haz 2022 |
| 5/7/2022 | Nis-Haz 2022 |
| 5/16/2022 | Nis-Haz 2022 |
| 6/15/2022 | Nis-Haz 2022 |
| 6/26/2022 | Nis-Haz 2022 |
| 7/9/2022 | Tem-Eyl 2022 |
| 7/22/2022 | Tem-Eyl 2022 |
| 7/23/2022 | Tem-Eyl 2022 |
| 7/27/2022 | Tem-Eyl 2022 |
| 8/2/2022 | Tem-Eyl 2022 |
| 8/8/2022 | Tem-Eyl 2022 |
| 8/19/2022 | Tem-Eyl 2022 |
| 9/26/2022 | Tem-Eyl 2022 |
| 10/14/2022 | Eki-Ara 2022 |
| 10/29/2022 | Eki-Ara 2022 |

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

quartername() fonksiyonu önce tarih değerinin içinde bulunduğu çeyreği belirler. Ardından hem bu çeyreğin başlangıç-bitiş aylarını hem de yılını gösteren bir değer döndürür.

quartername() fonksiyonu diyagramı, grafik nesnesi örneği

quartername() fonksiyonu diyagramı, grafik nesnesi örneği

quartername()quartername() fonksiyonu diyagramı, grafik nesnesi örneği![quartername fonksiyonunun işlemin gerçekleştiği çeyreğin ay aralığını nasıl belirlediğini gösteren diyagram.](https://help.qlik.com/tr-TR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-quartername-examples-chart-object.png)

8203 numaralı işlem 8 Ağustos 2022'de gerçekleşmiştir. quartername() fonksiyonu işlemin üçüncü çeyrekte gerçekleştiğini belirler ve bu nedenle Tem-Eyl 2022 döndürür. Aylar, MonthNames sistem değişkeniyle aynı biçimde görüntülenir.

## Örnek 5 – Senaryo

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/quartername.htm)

#### Komut dosyası ve grafik ifadesi

Genel bakış

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

Komut dosyası şunları içerir:

* Transactions adlı tabloya yüklenen, 2022'nin işlemlerini 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ı, toplam satışları işlemlerin çeyreğine göre sunan bir grafik nesnesi istemektedir. Bu, veri modelinde bu boyut mevcut olmadığında bile, grafikte hesaplanan boyut olarak quartername() fonksiyonunun kullanılmasıyla elde edilebilir.

Komut dosyası

```
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/7/2022',17.17
8189,'1/19/2022',37.23
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

Sonuçlar

Aşağıdakileri yapın:

1. Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun.

2. Şu ifadeyi kullanarak hesaplanan bir boyut oluşturun:

   =quartername(date)

3. Ardından, aşağıdaki toplama hesaplamasını kullanarak toplam satışları hesaplayın:

   =sum(amount)

4. Hesaplamanın Sayı Biçimini Para olarak ayarlayın.

Sonuçlar tablosu

| =quartername(date) | =sum(amount) |
| --- | --- |
| Tem-Eyl 2022 | $446.31 |
| Nis-Haz 2022 | $351.48 |
| Oca-Mar 2022 | $253.89 |
| Eki-Ara 2022 | $163.91 |