# yearname Komut dosyası ve grafik fonksiyonu

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()` fonksiyonunun zaman aralığının diyagramı.

`yearname()` fonksiyonunun zaman aralığının diyagramı.

`yearname()`yearname() fonksiyonunun zaman aralığının diyagramı. ![yearname fonksiyonunun bir sonuç döndüreceği zaman aralığını gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-diagram1.png)

`yearname()` fonksiyonu; değerlendirilmesini istediğiniz tarihi kaydırmanıza ve yılın ilk ayını ayarlamanıza izin verdiği için `year()` fonksiyonundan farklıdır.

Yılın ilk ayı Ocak değilse, fonksiyon, tarihi içeren on iki aylık dönem kapsayan dört rakamlı iki yıl döndürür. Örneğin yılın başlangıcı Nisan ve değerlendirilen tarih 06/30/2020 ise, döndürülen sonuç `2020-2021` olur.

`yearname()` fonksiyonunun, yılın ilk ayı Nisan'a ayarlanmış olarak diyagramı.

`yearname()` fonksiyonunun, yılın ilk ayı Nisan'a ayarlanmış olarak diyagramı.

`yearname()`yearname() fonksiyonunun, yılın ilk ayı Nisan'a ayarlanmış olarak diyagramı. ![yearname fonksiyonunun, tarihleri on iki aylık bir dönem içinde tanımlayabildiğini ve sonucunun yılın ilk ayı olarak ayarlanan aya bağlı olduğunu gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-diagram2.png)

Söz Dizimi:

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

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

| 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 yılı belirtir. period\_no içindeki negatif değerler önceki yılları; pozitif değerler ise sonraki yılları 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. Bu durumda görüntü değeri iki yılı gösteren bir dize olur. |

`Yılın ilk ayını ayarlamak için first_month_of_year` bağımsız değişkeninde aşağıdaki değerleri kullanabilirsiniz:

first\_month\_of\_year değerleri

| Ay | Değer |
| --- | --- |
| Şubat | 2 |
| Mart | 3 |
| Nisan | 4 |
| Mayıs | 5 |
| Haziran | 6 |
| Temmuz | 7 |
| Ağustos | 8 |
| Eylül | 9 |
| Ekim | 10 |
| Kasım | 11 |
| Aralık | 12 |

yearname ne zaman kullanılmalı?

`yearname()` fonksiyonu toplamaları yıla göre karşılaştırmak için yararlıdır. Örneğin, ürünlerin toplam satışlarını yıla göre görmek istiyorsanız.

Bu boyutlar, Ana Takvim tablosunda bir alan oluşturmak için fonksiyon kullanılarak komut dosyasında oluşturulabilir. Bir grafikte hesaplanan boyutlar olarak da oluşturulabilir

## Bölgesel ayarlar

Aksi belirtilmedikçe bu konudaki örneklerde aşağıdaki tarih formatı kullanılır: MM/DD/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](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

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 uygulamalar için varsayılan bölgeyi ayarlayabilirsiniz. Daha fazla bilgi için şuraya bakın: [Qlik Cloud Analizleri içinde uygulama ve komut dosyası oluşturmak için tercih ettiğiniz bölgesel ayarları belirleme](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

Fonksiyon örnekleri

| Örnek | Sonuç |
| --- | --- |
| `yearname('10/19/2001')` | '2001' döndürür. |
| `yearname('10/19/2001',-1)` | '2000' döndürür. |
| `yearname('10/19/2001',0,4)` | '2001-2002' döndürür. |

İlgili konular

| Konu | Açıklama |
| --- | --- |
| [year Komut dosyası ve grafik fonksiyonu](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/year.htm) | Bu fonksiyon, ifade standart sayı yorumlamasına göre tarih olarak yorumlandığında, yılı temsil eden bir tam sayı döndürür. |

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

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

#### Yükleme kodu 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:

* 2020 ile 2022 arasında yapılan bir işlemler kümesini içeren bir veri kümesi "`Transactions`" adlı tabloya yüklenir.

* "`MM/DD/YYYY`" olarak ayarlanan `DateFormat` sistem değişkeni.

* `year_name` alanı olarak ayarlanmış `yearname()` fonksiyonunu kullanan önceki bir yükleme.

Komut dosyası

```
SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
      *, 
      yearname(date) as year_name 
      ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/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,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/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_name`

Sonuçlar tablosu

| tarih | year\_name |
| --- | --- |
| 01/13/2020 | 2020 |
| 02/26/2020 | 2020 |
| 03/27/2020 | 2020 |
| 04/16/2020 | 2020 |
| 05/21/2020 | 2020 |
| 08/14/2020 | 2020 |
| 10/07/2020 | 2020 |
| 12/05/2020 | 2020 |
| 01/22/2021 | 2021 |
| 02/03/2021 | 2021 |
| 03/17/2021 | 2021 |
| 04/23/2021 | 2021 |
| 05/04/2021 | 2021 |
| 06/30/2021 | 2021 |
| 07/26/2021 | 2021 |
| 12/27/2021 | 2021 |
| 06/06/2022 | 2022 |
| 07/18/2022 | 2022 |
| 11/14/2022 | 2022 |
| 12/12/2022 | 2022 |

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

`yearname()` fonksiyonu, tarihin içinde kaldığı yılı tanımlar ve bunu dört rakamlı bir yıl değeri olarak döndürür.

`yearname()` fonksiyonunun 2021'i yıl değeri olarak gösterdiği diyagram.

`yearname()` fonksiyonunun 2021'i yıl değeri olarak gösterdiği diyagram.

`yearname()`yearname() fonksiyonunun 2021'i yıl değeri olarak gösterdiği diyagram. ![yearname() fonksiyonunun 17 Mart 2021 tarihi için 2021'i döndürdüğünü gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example1-diagram.png)

## Örnek 2 – period\_no

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

#### Yükleme kodu 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ı bir tabloya yüklenen, 2020 ile 2022 arasında yapılan işlemleri içeren bir veri kümesi.

* "`MM/DD/YYYY`" olarak ayarlanmış DateFormat sistem değişkeni.

* `year_name` alanı olarak ayarlanmış `yearname()` fonksiyonunu kullanan önceki bir yükleme.

Komut dosyası

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

Transactions: 
    Load 
      *, 
      yearname(date,-1) as prior_year_name 
      ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/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,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/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`
* `prior_year_name`

Sonuçlar tablosu

| tarih | prior\_year\_name |
| --- | --- |
| 01/13/2020 | 2019 |
| 02/26/2020 | 2019 |
| 03/27/2020 | 2019 |
| 04/16/2020 | 2019 |
| 05/21/2020 | 2019 |
| 08/14/2020 | 2019 |
| 10/07/2020 | 2019 |
| 12/05/2020 | 2019 |
| 01/22/2021 | 2020 |
| 02/03/2021 | 2020 |
| 03/17/2021 | 2020 |
| 04/23/2021 | 2020 |
| 05/04/2021 | 2020 |
| 06/30/2021 | 2020 |
| 07/26/2021 | 2020 |
| 12/27/2021 | 2020 |
| 06/06/2022 | 2021 |
| 07/18/2022 | 2021 |
| 11/14/2022 | 2021 |
| 12/12/2022 | 2021 |

`yearname()` fonksiyonunda kaydırma bağımsız değişkeni `period_no` için `-1` kullanıldığından, fonksiyon önce işlemlerin yapıldığı yılı tanımlar. Fonksiyon daha sonra bir yıl geriye gider ve elde edilen yılı döndürür.

`yearname()` fonksiyonunun `period_no` `-1` değerine ayarlanmış olarak diyagramı.

`yearname()` fonksiyonunun `period_no` `-1` değerine ayarlanmış olarak diyagramı.

`yearname()`yearname() fonksiyonunun `period_no`period\_no `-1`-1 değerine ayarlanmış olarak diyagramı. ![Negatif bir olan bir period_no alanının yearname() fonksiyonunun tanımladığı yıl aralığını nasıl değiştirdiğini gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example2-diagram.png)

## Örnek 3 – first\_month\_of\_year

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

#### Yükleme kodu 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:

* Birinci örnektekiyle aynı veri kümesi.

* '`MM/DD/YYYY`' olarak ayarlanan `DateFormat` sistem değişkeni.

* `year_name` alanı olarak ayarlanmış `yearname()` fonksiyonunu kullanan önceki bir yükleme.

Komut dosyası

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

Transactions: 
    Load 
      *, 
      yearname(date,0,4) as year_name 
      ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/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,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];
```

Sonuçlar

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

* `id`
* `date`
* `year_name`

Sonuçlar tablosu

| tarih | year\_name |
| --- | --- |
| 01/13/2020 | 2019-2020 |
| 02/26/2020 | 2019-2020 |
| 03/27/2020 | 2019-2020 |
| 04/16/2020 | 2020-2021 |
| 05/21/2020 | 2020-2021 |
| 08/14/2020 | 2020-2021 |
| 10/07/2020 | 2020-2021 |
| 12/05/2020 | 2020-2021 |
| 01/22/2021 | 2020-2021 |
| 02/03/2021 | 2020-2021 |
| 03/17/2021 | 2020-2021 |
| 04/23/2021 | 2021-2022 |
| 05/04/2021 | 2021-2022 |
| 06/30/2021 | 2021-2022 |
| 07/26/2021 | 2021-2022 |
| 12/27/2021 | 2021-2022 |
| 06/06/2022 | 2022-2023 |
| 07/18/2022 | 2022-2023 |
| 11/14/2022 | 2022-2023 |
| 12/12/2022 | 2022-2023 |

`yearname()` fonksiyonunda `first_month_of_year` bağımsız değişkeni için `4` kullanıldığından yılın başlangıcı 1 Ocak'tan 1 Nisan'a kayar. Bu nedenle her on iki aylık dönem iki takvim yılına yayılır ve `yearname()` fonksiyonu değerlendirilen tarihler için dört rakamlı iki yıl döndürür.

8198 numaralı işlem 17 Mart 2021'de yapılmıştır. `yearname()` fonksiyonu, yılın başlangıcını 1 Nisan, sonunu ise 30 Mart olarak ayarlar. Dolayısıyla 8198 numaralı işlem yılın 1 Nisan 2020 ile 30 Mart 2021 arasındaki dönemde yapılmıştır. Bunun sonucunda `yearname()` fonksiyonu 2020-2021 değerini döndürür.

`yearname()` fonksiyonunun, yılın ilk ayı Mart'a ayarlanmış olarak diyagramı.

`yearname()` fonksiyonunun, yılın ilk ayı Mart'a ayarlanmış olarak diyagramı.

`yearname()`yearname() fonksiyonunun, yılın ilk ayı Mart'a ayarlanmış olarak diyagramı. ![Yılın ilk ayı Mart olarak ayarlandığında yearname() fonksiyonunun tanımladığı zaman aralığını gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example3-diagram.png)

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

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.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:

* Birinci örnektekiyle aynı veri kümesi.

* '`MM/DD/YYYY`' olarak ayarlanan `DateFormat` sistem değişkeni.

Ancak işlemin yapıldığı yılı döndüren alan bir grafik nesnesinde bir hesaplama olarak oluşturulur.

Komut dosyası

```
SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/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,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/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`

"`year_name`" alanını hesaplamak için şu hesaplamayı oluşturun:

`=yearname(date)`

Sonuçlar tablosu

| tarih | =yearname(date) |
| --- | --- |
| 01/13/2020 | 2020 |
| 02/26/2020 | 2020 |
| 03/27/2020 | 2020 |
| 04/16/2020 | 2020 |
| 05/21/2020 | 2020 |
| 08/14/2020 | 2020 |
| 10/07/2020 | 2020 |
| 12/05/2020 | 2020 |
| 01/22/2021 | 2021 |
| 02/03/2021 | 2021 |
| 03/17/2021 | 2021 |
| 04/23/2021 | 2021 |
| 05/04/2021 | 2021 |
| 06/30/2021 | 2021 |
| 07/26/2021 | 2021 |
| 12/27/2021 | 2021 |
| 06/06/2022 | 2022 |
| 07/18/2022 | 2022 |
| 11/14/2022 | 2022 |
| 12/12/2022 | 2022 |

"`year_name`" hesaplaması, grafik nesnesinde `yearname()` fonksiyonu kullanılarak ve tarih alanı fonksiyonun bağımsız değişkeni olarak geçilerek oluşturulur.

`yearname()` fonksiyonu, tarihin içinde kaldığı yılı tanımlar ve bunu dört rakamlı bir yıl değeri olarak döndürür.

`yearname()` fonksiyonunun yıl değeri 2021 olarak diyagramı.

`yearname()` fonksiyonunun yıl değeri 2021 olarak diyagramı.

`yearname()`yearname() fonksiyonunun yıl değeri 2021 olarak diyagramı. ![yearname() fonksiyonunu yıl değeri olarak 2021 döndürürken gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-yearname-example4-diagram.png)

## Örnek 5 – Senaryo

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/yearname.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:

* Birinci örnektekiyle aynı veri kümesi.

* 'MM/DD/YYYY' olarak ayarlanan DateFormat sistem değişkeni.

Son kullanıcı, toplam satışları işlemler için çeyreğe göre sunan bir grafik istemektedir. Veri modelinde yearname() boyutu mevcut olmadığında, bu grafiği oluşturmak için hesaplanan boyut olarak yearname() fonksiyonunu kullanın.

Komut dosyası

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

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/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,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67 
];
```

Sonuçlar

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

Yıla göre toplama karşılaştırmak için şu hesaplanan boyutu oluşturun:

=yearname(date)

Şu hesaplamayı oluşturun:

=sum(amount)

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

Sonuçlar tablosu

| yearname(date) | =sum(amount) |
| --- | --- |
| 2020 | $463.55 |
| 2021 | $457.69 |
| 2022 | $294.35 |