# yeartodate - 脚本和图表函数

此函数用于判断输入日期是否在最后加载脚本的日期的年份以内，并返回 True（如果在）或返回 False（如果不在）。

语法：

YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])

**返回数据类型：**布尔值

如果未使用可选参数，年初至今指日历年中 1 月 1 日以后任何一天，包括最近一次脚本执行日期。

参数：

YearToDate 参数

| 参数 | 说明 |
| --- | --- |
| 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 |