此函數會找出輸入日期是否落於上次載入指令碼的日期年度內，如果是，會傳回 True；如果不是，會傳回 False。
語法：
YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
傳回資料類型：布林
如未使用任何選用參數，年初至今表示是從 1 月 1 日起，在一個日曆年內的任何日期，但不超過 (可包含) 上次指令碼執行的日期。
引數：
| 引數 | 描述 |
|---|---|
| timestamp | 要轉換的時間戳記或解析為時間戳記的運算式的日期，例如 '2012-10-12'。 |
| yearoffset |
透過指定 yearoffset，yeartodate 針對另一年中的相同期間傳回 True。負數 yearoffset 表示前一年，正數是未來年的位移。最新的年結束日期透過指定 yearoffset = -1 實現。如果省略，則採用 0。 |
| firstmonth |
透過指定 firstmonth 介於 1 和 12 之間 (如果省略，則為 1)，可將年開始向前移到任何月份的第一天。例如，如果要使用起始於 5 月 1 日的會計年度，可指定 firstmonth = 5。 |
| todaydate | 透過指定 todaydate (如果省略，則為上次指令碼執行的時間戳記)，即可移動作為期間上限的日期。 |
範例與結果：
下列範例假設最後一個重新載入時間 = 2011-11-18
| 範例 | 結果 |
|---|---|
| yeartodate( '2010-11-18') | 傳回 False |
| yeartodate( '2011-02-01') | 傳回 True |
| yeartodate( '2011-11-18') | 傳回 True |
| yeartodate( '2011-11-19') | 傳回 False |
| yeartodate( '2011-11-19', 0, 1, '2011-12-31') | 傳回 True |
| yeartodate( '2010-11-18', -1) | 傳回 True |
| yeartodate( '2011-11-18', -1) | 傳回 False |
| yeartodate( '2011-04-30', 0, 5) | 傳回 False |
| yeartodate( '2011-05-01', 0, 5) | 傳回 True |
