# today - Komut dosyası ve grafik fonksiyonu
Fonksiyon geçerli tarihi döndürür. Fonksiyon, `DateFormat` sistem değişkeni biçiminde değerler döndürür.
Söz Dizimi:
today([ timer\_mode])
Dönüş verileri türü: dual
`today()` fonksiyonu komut dosyasında veya grafik nesnelerinde kullanılabilir.
Varsayılan `timer_mode` değeri 1'dir.
Bağımsız Değişkenler
| Bağımsız Değişken | Açıklama |
| --- | --- |
| timer\_mode | Aşağıdaki değerleri alabilir:
0 (son tamamlanan veri yüklemesi günü)
1 (fonksiyon çağrısı günü)
2 (uygulamanın açıldığı gün)
Bilgi notuFonksiyonu bir komut dosyasında kullanırsanız, timer\_mode=0 son bitirilen veri yüklemesinin gününü sonuç olarak verirken timer\_mode=1 geçerli veri yüklemesinin gününü verir. |
Fonksiyon örnekleri
| timer\_mode değeri | Komut dosyasında kullanıldığında sonuç | Grafik nesnesinde kullanıldığında sonuç |
| --- | --- | --- |
| 0 | En son veri yeniden yüklemesinden önceki son başarılı veri yeniden yüklemesinin tarihini, `DateFormat` sistem değişkeni biçiminde döndürür. | En son veri yeniden yüklemesi için `DateFormat` sistem değişkeni biçiminde bir tarih döndürür. |
| 1 | En son veri yeniden yüklemesi için `DateFormat` sistem değişkeni biçiminde bir tarih döndürür. | Fonksiyon çağrısının `DateFormat` sistem değişkeni biçimindeki tarihini döndürür. |
| 2 | Kullanıcının uygulamadaki oturumunun başlangıcı için `DateFormat` sistem değişkeni biçiminde bir tarih döndürür. Kullanıcı kodu yeniden yüklemediği sürece bu değer güncellenmez. | Kullanıcının uygulamadaki oturumunun başlangıç tarihini `DateFormat` sistem değişkeni biçiminde döndürür. Yeni bir oturum başladığında veya uygulamadaki veriler yeniden yüklendiğinde bu değer yenilenir. |
## Ne zaman kullanılır?
`today()` fonksiyonu genelde bir ifadenin içinde bileşen olarak kullanılır. Örneğin, ay içinde geçerli tarihe kadar biriken faizi hesaplamak için kullanılabilir.
Aşağıdaki tabloda, `timer_mode` bağımsız değişkenine farklı değerler verilerek `today()` fonksiyonu tarafından döndürülen sonucun açıklaması sağlanmıştı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 – Komut dosyası kullanarak nesneleri oluşturma
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Yükleme kodu ve sonuçlar
Genel bakış
Aşağıdaki örnekte `today()` fonksiyonu kullanılarak üç değişken oluşturulur. Her değişken, etkisini göstermek için `timer_mode` seçeneklerinden birini kullanır.
Değişkenlerin amacının gösterilmesi için komut dosyasını yeniden yükleyin ve 24 saat sonra komut dosyasını ikinci kez yeniden yükleyin. Bunun sonucunda `today(0)` ve `today(1)` değişkenleri farklı değerler gösterecek ve bu şekilde amaçlarını doğru bir şekilde ortaya koyacaktır.
Komut dosyası
```
LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);
```
Sonuçlar
Veriler ikinci kez yüklendikten sonra aşağıdaki talimatları kullanarak üç metin kutusu oluşturun.
Önce daha önce yüklenmiş olan veriler için bir metin kutusu oluşturun.
Aşağıdakileri yapın:
1. Metin ve Resim grafik nesnesini kullanarak bir metin kutusu oluşturun.
2. Şu hesaplamayı nesneye ekleyin:
`=vPreviousDataLoad`
3. Görünüm'ün altından Show titles'i seçin ve 'Önceki Yeniden Yükleme Zamanı' başlığını nesneye ekleyin.
Sonra, yüklenmekte olan veriler için bir metin kutusu oluşturun.
Aşağıdakileri yapın:
1. Metin ve Resim grafik nesnesini kullanarak bir metin kutusu oluşturun.
2. Şu hesaplamayı nesneye ekleyin:
`=vCurrentDataLoad`
3. Görünüm'ün altından Show titles'ı seçin ve 'Geçerli Yeniden Yükleme Zamanı' başlığını nesneye ekleyin.
Kullanıcının uygulamadaki oturumunun başladığı zamanı gösteren son bir metin kutusu oluşturun.
Aşağıdakileri yapın:
1. Metin ve Resim grafik nesnesini kullanarak bir metin kutusu oluşturun.
2. Şu hesaplamayı nesneye ekleyin:
`=vApplicationOpened`
3. GÖrünüm'ün altından Show titles'i seçin ve 'Kullanıcı Oturumu Başlangıcı' başlığını nesneye ekleyin.
Komut dosyasında `today()` fonksiyonu kullanılarak oluşturulan değişkenlerin diyagramı
Komut dosyasında `today()` fonksiyonu kullanılarak oluşturulan değişkenlerin diyagramı
Komut dosyasında `today()`today() fonksiyonu kullanılarak oluşturulan değişkenlerin diyagramı
Yukarıdaki resimde, oluşturulan değişkenlerin her biri için örnek değerler gösterilir. Örneğin değerler şöyle olabilir:
* Önceki Yeniden Yükleme Zamanı: 06/22/2022
* Geçerli Yeniden Yükleme Zamanı: 06/23/2022
* Kullanıcı Oturumu Başlangıcı: 06/23/2022
## Örnek 2 – Komut dosyası olmadan nesneleri oluşturma
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.htm)
#### Komut dosyası ve grafik ifadesi
Genel bakış
Aşağıdaki örnekte `today()` fonksiyonu kullanılarak üç grafik nesnesi oluşturulur. Her grafik nesnesi, etkisini göstermek için `timer_mode` seçeneklerinden birini kullanır.
Bu örnekte komut dosyası yoktur.
Sonuçlar
Veriler bir kez daha yüklendikten sonra üç metin kutusunu oluşturun.
Önce en son veri yeniden yüklemesi için bir metin kutusu oluşturun.
Aşağıdakileri yapın:
1. Metin ve Resim grafik nesnesini kullanarak bir metin kutusu oluşturun.
2. Aşağıdaki hesaplamayı ekleyin:
`=today(0)`
3. Görünüm'ün altında Başlıkları göster seçeneğini belirleyin ve nesneye "En Son Veri Yeniden Yüklemesi" başlığını ekleyin.
Ardından geçerli saati gösterecek bir metin kutusu oluşturun.
Aşağıdakileri yapın:
1. Metin ve Resim grafik nesnesini kullanarak bir metin kutusu oluşturun.
2. Aşağıdaki hesaplamayı ekleyin:
`=today(1)`
3. Görünüm'ün altında Başlıkları göster seçeneğini belirleyin ve nesneye "Geçerli Saat" başlığını ekleyin.
Kullanıcının uygulamadaki oturumunun başladığı zamanı gösteren son bir metin kutusu oluşturun.
Aşağıdakileri yapın:
1. Metin ve Resim grafik nesnesini kullanarak bir metin kutusu oluşturun.
2. Aşağıdaki hesaplamayı ekleyin:
`=today(2)`
3. Görünüm'ün altında Başlıkları göster seçeneğini belirleyin ve nesneye "Kullanıcı Oturumu Başlangıcı" başlığını ekleyin.
Komut dosyası olmadan `today()` fonksiyonu kullanılarak oluşturulan nesnelerin diyagramı
Komut dosyası olmadan `today()` fonksiyonu kullanılarak oluşturulan nesnelerin diyagramı
Komut dosyası olmadan `today()`today() fonksiyonu kullanılarak oluşturulan nesnelerin diyagramı
Yukarıdaki resimde, oluşturulan nesnelerin her biri için örnek değerler gösterilir. Örneğin değerler şöyle olabilir:
* En Son Veri Yeniden Yüklemesi: 06/23/2022
* Geçerli Zaman: 06/23/2022
* Kullanıcı Oturumu Başlangıcı: 06/23/2022
'En Son Veri Yeniden Yüklemesi' grafik nesnesi, değeri 0 olan bir `timer_mode` kullanır. Bu, verilerin son kez başarıyla yeniden yüklendiği zamanın zaman damgasını döndürür.
'Geçerli Zaman' grafik nesnesi değeri 1 olan bir `timer_mode` kullanır. Bu, sistem saatine göre geçerli zamanı döndürür. Sayfa veya nesne yenilenirse bu değer güncellenir.
'Kullanıcı Oturumu Başlangıcı' grafik nesnesi, değeri 2 olan bir `timer_mode` kullanır. Bu, uygulamanın açıldığı ve kullanıcı oturumunun başladığı zaman damgasını döndürür.
## Örnek 3 – Senaryo
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/today.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:
* Kredi bakiyelerini içeren ve `Loans` adlı tabloya yüklenen bir veri kümesi.
* Kredi kimliği, ayın başındaki bakiye ve her krediye uygulanan yıllık düz faiz oranı alanlarını içeren tablo verileri.
Son kullanıcı, ay başından bugüne kadar her kredide biriken cari faizi kredi kimliğine göre görüntüleyen bir grafik nesnesi istemektedir. Uygulama yalnızca haftada bir yeniden yükleniyor olsa da, kullanıcı nesne veya uygulama her yenilendiğinde sonuçların yenilenmesini istemektedir.
Komut dosyası
```
Loans:
Load
*
Inline
[
loan_id,start_balance,rate
8188,$10000.00,0.024
8189,$15000.00,0.057
8190,$17500.00,0.024
8191,$21000.00,0.034
8192,$90000.00,0.084
];
```
Sonuçlar
Aşağıdakileri yapın:
1. Verileri yükleyin ve bir sayfa açın. Yeni bir tablo oluşturun.
2. Aşağıdaki alanları boyut olarak ekleyin:
* `loan_id`
* `start_balance`
3. Sonra biriken faizi hesaplamak için bir hesaplama oluşturun:
`=start_balance*(rate*(today(1)-monthstart(today(1)))/365)`
4. Hesaplamanın Sayı Biçimini Para olarak ayarlayın.
Sonuçlar tablosu
| loan\_id | start\_balance | =start\_balance\*(rate\*(today(1)-monthstart(today(1)))/365) |
| --- | --- | --- |
| 8188 | $10000,00 | $16,44 |
| 8189 | $15000,00 | $58,56 |
| 8190 | $17500,00 | $28,77 |
| 8191 | $21000,00 | $48,90 |
| 8192 | $90000,00 | $517,81 |
`monthstart()` fonksiyonu, tek bağımsız değişkeni olarak bugünün tarihini döndürmek için `today()` fonksiyonunu kullanır ve geçerli ayın başlangıç tarihini döndürür. Yine `today()` fonksiyonu kullanılarak bu sonuç geçerli tarihten çıkarılır ve ifade bu ay içinde şimdiye kadar geçen gün sayısını döndürür.
Sonra bu değer faiz oranıyla çarpılıp 365'e bölünerek bu dönemde biriken efektif faiz oranı döndürülür. Ardından, sonuç kredinin başlangıç bakiyesiyle çarpılarak bu ay içinde şimdiye kadar biriken faiz döndürülür.
İfadenin içindeki `today()` fonksiyonlarında `timer_mode` bağımsız değişkeni olarak 1 değeri kullanıldığından, grafik nesnesi her yenilendiğinde (uygulama açılarak, sayfa yenilenerek, sayfalar arasında gezinilerek vb.) döndürülen tarih geçerli tarih olur ve sonuçlar buna göre yenilenir.