Bu fonksiyon, giriş tarihinin kodun en son yüklendiği tarihin yılına denk gelip gelmediğini bulur ve öyleyse True, öyle değilse de False döndürür.
Söz Dizimi:
YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
Dönüş veri türü: Boole
İsteğe bağlı parametrelerden hiçbiri kullanılmazsa, yeartodate, 1 Ocak'tan son kod yürütme tarihine kadar ve bu tarihi de içerecek şekilde, bir takvim yılı dahilindeki herhangi bir tarih anlamına gelir.
Bağımsız Değişkenler:
| Bağımsız Değişken | Açıklama |
|---|---|
| timestamp | Zaman damgası veya dönüştürülmek üzere zaman damgasına çözümlenen ifade (örneğin, '2012-10-12'). |
| yearoffset |
Bir yearoffset belirtilmesiyle, yeartodate başka bir yıldaki aynı dönem için True değerini döndürür. Negatif yearoffset önceki bir yılı belirtirken, pozitif kayma gelecekteki bir yılı belirtir. En yeni year-to-date yearoffset = -1 olarak belirtilmesiyle elde edilir. Atlandığı takdirde 0 olduğu varsayılır. |
| firstmonth |
1 ile 12 arasında bir firstmonth belirtildiğinde (atlandığı takdirde 1) yılın başlangıcı herhangi bir ayın ilk gününe ileri taşınabilir. Örneğin, 1 Mayıs'ta başlayan bir mali yıl ile çalışmak istiyorsanız firstmonth = 5 olarak belirtin. |
| todaydate | Bir todaydate belirtildiğinde (atlandığı takdirde son kod çalıştırma işleminin zaman damgası), dönemin üst sınırı olarak kullanılan günü taşımak mümkündür. |
Örnekler ve sonuçlar:
Aşağıdaki örneklerde son yeniden yükleme zamanının = 2011-11-18 olduğu varsayılır
| Örnek | Sonuç |
|---|---|
| yeartodate( '2010-11-18') | şunu döndürür: False |
| yeartodate( '2011-02-01') | şunu döndürür: True |
| yeartodate( '2011-11-18') | şunu döndürür: True |
| yeartodate( '2011-11-19') | şunu döndürür: False |
| yeartodate( '2011-11-19', 0, 1, '2011-12-31') | şunu döndürür: True |
| yeartodate( '2010-11-18', -1) | şunu döndürür: True |
| yeartodate( '2011-11-18', -1) | şunu döndürür: False |
| yeartodate( '2011-04-30', 0, 5) | şunu döndürür: False |
| yeartodate( '2011-05-01', 0, 5) | şunu döndürür: True |
