此函数用于判断输入日期是否在最后加载脚本的日期的年份以内，并返回 True（如果在）或返回 False（如果不在）。
语法：
YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
返回数据类型：布尔值
如果未使用可选参数，年初至今指日历年中 1 月 1 日以后任何一天，包括最近一次脚本执行日期。
参数：
| 参数 | 说明 |
|---|---|
| timestamp | 要作为时间戳评估的日期或要解析为时间戳的表达式，例如转换为“2012-10-12”。 |
| yearoffset |
通过指定 yearoffset，yeartodate 对于其他年份的同一时期返回 True。yearoffset 为负表示上一年，偏移量为正表示下一年。通过指定 yearoffset = -1 获得至今的最近一年。如果忽略，则假设为 0。 |
| firstmonth |
通过在 1 和 12 之间（如果省略，则为 1）指定 firstmonth，年初可移动到任何一个月的第一天。例如，如果您想要从 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 |
