此函数用于判断输入时间戳是否在最后加载脚本的日期的年份以内，并返回 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（如果忽略执行上次脚本时间戳），这可作为该时期的上限移动该日。 |