# inyeartodate Komut dosyası ve grafik fonksiyonu

Bu fonksiyon, timestamp, yılın base\_date öğesinin son milisaniyesine kadar ve bu milisaniye de dahil olmak üzere base\_date öğesini içeren bölümünde bulunuyorsa, True sonucunu döndürür.

Söz Dizimi:

InYearToDate (timestamp, base\_date, period\_no[, first\_month\_of\_year])

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

Bilgi notu

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

inyeartodate fonksiyonu diyagramı

inyeartodate fonksiyonu diyagramı

inyeartodate fonksiyonu diyagramı ![inyeartodate fonksiyonunun TRUE değerini döndüreceği tarih aralığının örnek diyagramı.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inyeartodate-general.png)

`inyeartodate()` fonksiyonu yılın belirli bir kısmını `base_date` ile dilimleyerek o dilim için kabul edilebilen en son tarihi tanımlar. Fonksiyon daha sonra bir tarih alanının veya değerinin bu dilim içinde kalıp kalmadığını değerlendirerek bir Boole sonucu döndürür.

Bağımsız Değişkenler

| Bağımsız Değişken | Açıklama |
| --- | --- |
| timestamp | base\_date ile karşılaştırmak istediğiniz tarih. |
| base\_date | Yılı değerlendirmek için kullanılan tarih. |
| period\_no | Yıl period\_no ile kaydırılabilir. period\_no, 0 değerinin base\_date değerini içeren yılı gösterdiği bir tamsayıdır. 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. |

## inyeartodate ne zaman kullanılmalı?

`inyeartodate()` fonksiyonu bir Boole sonucu döndürür. Bu tür bir fonksiyon genellikle bir `if` ifadesinde koşul olarak kullanılır. Değerlendirilen bir tarihin, kendisi de dahil yıl içinde kalıp kalmadığına bağlı olarak bir toplama veya hesaplama döndürür.

`inyeartodate()` fonksiyonu örneğin bir yıl içinde belirli bir tarihe kadar üretilen tüm ekipmanı tanımlamak için 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ç |
| --- | --- |
| `inyeartodate ('01/25/2013', '02/01/2013', 0)` | `TRUE` döndürür. |
| `inyeartodate ('01/25/2012', '01/01/2013', 0)` | `FALSE` döndürür. |
| `inyeartodate ('01/25/2012', '02/01/2013', -1)` | `TRUE` döndürür. |
| `inyeartodate ('11/25/2012', '01/31/2013', 0, 4)` | `TRUE` döndürür.<br>`timestamp` değeri, dördüncü ayda başlayan mali yılın içine ve `base_date` değerinden öncesine denk gelir. |
| `inyeartodate ('3/31/2013', '01/31/2013', 0, 4 )` | `FALSE` döndürür.<br>Önceki örnek ile karşılaştırıldığında `timestamp` değeri halen ilgili mali yılın içindedir; ancak `base_date` değerinden sonra olduğundan yıl bölümünün dışında kalır. |

## 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).

## Ö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/inyeartodate.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ı 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.

* Yıl içinde 26 Temmuz 2021'e kadar yapılan işlemleri belirleyen `in_year_to_date` alanının oluşturulması.

Komut dosyası

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

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', 0) as in_year_to_date
        ;
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,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/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,'07/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`

* `in_year_to_date`

Sonuçlar tablosu

| tarih | in\_year\_to\_date |
| --- | --- |
| 01/13/2020 | 0 |
| 02/26/2020 | 0 |
| 03/27/2020 | 0 |
| 04/16/2020 | 0 |
| 05/21/2020 | 0 |
| 06/14/2020 | 0 |
| 08/07/2020 | 0 |
| 09/05/2020 | 0 |
| 01/22/2021 | -1 |
| 02/03/2021 | -1 |
| 03/17/2021 | -1 |
| 04/23/2021 | -1 |
| 05/04/2021 | -1 |
| 06/30/2021 | -1 |
| 07/26/2021 | -1 |
| 07/27/2021 | 0 |
| 06/06/2022 | 0 |
| 07/18/2022 | 0 |
| 11/14/2022 | 0 |
| 12/12/2022 | 0 |

`in_year_to_date` alanı, öncelikli yükleme deyiminde `inyeartodate()` fonksiyonu kullanılarak oluşturulur. Sağlanan ilk bağımsız değişken hangi alanın değerlendirildiğini tanımlar.

İkinci bağımsız değişken, yıl diliminin son sınırını tanımlayan `base_date` değeri olarak sabit kodlanmış 26 Temmuz 2021 tarihidir. `period_no` için 0 son bağımsız değişkendir; fonksiyonun dilimlenen yıldan önceki veya sonraki yılları karşılaştırmadığı anlamına gelir.

inyeartodate fonksiyonu diyagramı; ek bağımsız değişken yok

inyeartodate fonksiyonu diyagramı; ek bağımsız değişken yok

inyeartodate fonksiyonu diyagramı; ek bağımsız değişken yok ![inyeartodate fonksiyonunun TRUE değerini döndüreceği tarih aralığını gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inyeartodate-examples-no-additional-arguments.png)

1 Ocak ile 26 Temmuz arasında yapılan işlemler `TRUE` Boole sonucunu döndürür. 2021'den önceki ve 26 Temmuz 2021'den sonraki işlemler `FALSE` döndürür.

## Örnek 2 – period\_no

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

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

* Yılın 26 Temmuz 2021'de biten diliminden tam bir yıl önce yapılan işlemleri belirleyen `previous_year_to_date` alanının oluşturulması.

Komut dosyası

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

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', -1) as previous_year_to_date
        ;
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,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/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,'07/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`

* `previous_year_to_date`

Sonuçlar tablosu

| tarih | previous\_year\_to\_date |
| --- | --- |
| 01/13/2020 | -1 |
| 02/26/2020 | -1 |
| 03/27/2020 | -1 |
| 04/16/2020 | -1 |
| 05/21/2020 | -1 |
| 06/14/2020 | -1 |
| 08/07/2020 | 0 |
| 09/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 |
| 07/27/2021 | 0 |
| 06/06/2022 | 0 |
| 07/18/2022 | 0 |
| 11/14/2022 | 0 |
| 12/12/2022 | 0 |

`period_no` için -1 değeri, `inyeartodate ()` fonksiyonunun girilen çeyrek dilimini önceki yıl ile karşılaştırdığını gösterir. Girilen tarih 26 Temmuz 2021 olduğunda, başlangıçta 1 Ocak 2021 ile 26 Temmuz 2021 arasındaki dilim yıl başından bugüne olarak tanımlanır. `period_no` daha sonra bu dilimi tam bir yıl öncesine kaydırarak tarih sınırlarının 1 Ocak ile 26 Temmuz 2020 olmasına neden olur.

inyeartodate fonksiyonu diyagramı; period\_no örneği

inyeartodate fonksiyonu diyagramı; period\_no örneği

inyeartodate fonksiyonu diyagramı; period\_no örneği ![inyeartodate fonksiyonunun TRUE değerini döndüreceği tarih aralığını gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inyeartodate-examples-period-no.png)

Dolayısıyla 1 Ocak ile 26 Temmuz 2020 arasında yapılan işlemler `TRUE` Boole sonucunu döndürür.

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

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

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

* Aynı yıl içinde 26 Temmuz 2021'e kadar yapılan işlemleri belirleyen `in_year_to_date` alanının oluşturulması.

Bu örnekte Mart ayını mali yılın ilk ayı olarak ayarlıyoruz.

Komut dosyası

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

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', 0,3) as in_year_to_date
        ;
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,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/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,'07/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`

* `in_year_to_date`

Sonuçlar tablosu

| tarih | in\_year\_to\_date |
| --- | --- |
| 01/13/2020 | 0 |
| 02/26/2020 | 0 |
| 03/27/2020 | 0 |
| 04/16/2020 | 0 |
| 05/21/2020 | 0 |
| 06/14/2020 | 0 |
| 08/07/2020 | 0 |
| 09/05/2020 | 0 |
| 01/22/2021 | 0 |
| 02/03/2021 | 0 |
| 03/17/2021 | -1 |
| 04/23/2021 | -1 |
| 05/04/2021 | -1 |
| 06/30/2021 | -1 |
| 07/26/2021 | -1 |
| 07/27/2021 | 0 |
| 06/06/2022 | 0 |
| 07/18/2022 | 0 |
| 11/14/2022 | 0 |
| 12/12/2022 | 0 |

`inyeartodate()` fonksiyonunda `first_month_of_year` bağımsız değişkeninde 3 kullanıldığında, fonksiyon yılı 1 Mart'ta başlatır. 26 Temmuz 2021 için `base_date` daha sonra o yıl diliminin bitiş tarihini ayarlar.

inyeartodate fonksiyonu diyagramı; first\_month\_of\_year örneği

inyeartodate fonksiyonu diyagramı; first\_month\_of\_year örneği

inyeartodate fonksiyonu diyagramı; first\_month\_of\_year örneği ![inyeartodate fonksiyonunun TRUE değerini döndüreceği tarih aralığını gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inyeartodate-examples-first-mth-yr.png)

Dolayısıyla 1 Mart ile 26 Temmuz 2021 arasında yapılan işlemler `TRUE` Boole sonucunu, buna karşın bu sınırlar dışında kalan tarihleri olan işlemler `FALSE` değerini döndürür.

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

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inyeartodate.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. Aynı yıl içinde 26 Temmuz 2021'e kadar hangi işlemlerin yapıldığını belirleyen hesaplama, uygulamadaki bir grafik nesnesi içinde 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,'06/14/2020',82.06 
8194,'08/07/2020',40.39 
8195,'09/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,'07/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:datedeğişkenlerini silin.

Şu hesaplamayı oluşturun:

=inyeartodate(date,'07/26/2021', 0)

Sonuçlar tablosu

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

Grafik nesnesinde inyeartodate() fonksiyonu kullanılarak in\_year\_to\_date hesaplaması oluşturulur. Sağlanan ilk bağımsız değişken hangi alanın değerlendirildiğini tanımlar. İkinci bağımsız değişken, karşılaştırıcı yıl diliminin son sınırını tanımlayan base\_date değeri olarak sabit kodlanmış 26 Temmuz 2021 tarihidir. period\_no için 0 son bağımsız değişkendir; fonksiyonun dilimlenen yıldan önceki veya sonraki yılları karşılaştırmadığı anlamına gelir.

inyeartodate fonksiyonu diyagramı; grafik nesnesi örneği

inyeartodate fonksiyonu diyagramı; grafik nesnesi örneği

inyeartodate fonksiyonu diyagramı; grafik nesnesi örneği ![inyeartodate fonksiyonunun TRUE değerini döndüreceği tarih aralığını gösteren diyagram.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-inyeartodate-examples-chart-object.png)

1 Ocak ile 26 Temmuz 2021 arasında yapılan işlemler TRUE Boole sonucunu döndürür. 2021'den önceki ve 26 Temmuz 2021'den sonra işlem tarihleri FALSE döndürür.

## Örnek 5 – Senaryo

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

* Products adlı tabloya yüklenen bir veri kümesi.

* Ürün kimliği, ürün türü, üretim tarihi ve maliyet fiyatı ile ilgili bilgiler.

Son kullanıcı, 2021'de 26 Temmuz'a kadar üretilen ürünlerin maliyetini ürün türüne göre görüntüleyen bir grafik nesnesi istemektedir.

Komut dosyası

```
Products:
Load
*
Inline
[
product_id,product_type,manufacture_date,cost_price
8188,product A,'01/13/2020',37.23
8189,product B,'02/26/2020',17.17
8190,product B,'03/27/2020',88.27
8191,product C,'04/16/2020',57.42
8192,product D,'05/21/2020',53.80
8193,product D,'08/14/2020',82.06
8194,product C,'10/07/2020',40.39
8195,product B,'12/05/2020',87.21
8196,product A,'01/22/2021',95.93
8197,product B,'02/03/2021',45.89
8198,product C,'03/17/2021',36.23
8199,product C,'04/23/2021',25.66
8200,product B,'05/04/2021',82.77
8201,product D,'06/30/2021',69.98
8202,product D,'07/26/2021',76.11
8203,product D,'12/27/2021',25.12
8204,product C,'06/06/2022',46.23
8205,product C,'07/18/2022',84.21
8206,product A,'11/14/2022',96.24
8207,product B,'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:product\_typedeğişkenlerini silin.

2021'de 27 Temmuz'dan önce üretilen her ürünün toplamını hesaplayan bir hesaplama oluşturun:

=sum(if(inyeartodate(manufacture\_date,makedate(2021,07,26),0),cost\_price,0))

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

Sonuçlar tablosu

| product\_type | =sum(if(inyeartodate(manufacture\_date,makedate(2021,07,26),0),cost\_price,0)) |
| --- | --- |
| A ürünü | $95.93 |
| B ürünü | $128.66 |
| C ürünü | $61.89 |
| D ürünü | $146.09 |

inyeartodate() fonksiyonu, ürünlerin her birinin üretim tarihlerini değerlendirirken mantıksal bir değer döndürür. 2021'de 27 Temmuz'dan önce üretilen tüm ürünler için inyeartodate() fonksiyonu TRUE Boole değerini döndürür ve cost\_price alanını toplar.

D ürünü, 2021'de 26 Temmuz'dan sonra da üretilen tek üründür. product\_ID değeri 8203 olan giriş 27 Aralık'ta üretilmiştir ve maliyeti $25.12'dir. Bu nedenle bu maliyet, grafik nesnesinde D Ürünü için toplama dahil edilmemiştir.