此函数用于返回与包含 date 的年份的第一天的开始对应的时间戳。默认的输出格式为在脚本中所设置的 DateFormat。
语法：
YearStart(date[, period_no[, first_month_of_year]])
返回数据类型：双
参数：
| 参数 | 说明 |
|---|---|
| date | 要求值的日期。 |
| period_no | period_no 为整数，其中值 0 表示该年份包含 date。period_no 为负数表示前几年，为正数表示随后几年。 |
| first_month_of_year | 如果您不想从一月开始处理（财政）年，可在 first_month_of_year 中指定一个介于 2 和 12 之间的值。 |
示例和结果：
以下示例使用日期格式 DD/MM/YYYY。日期格式已经在加载脚本顶部的 SET DateFormat 语句中指定。可以根据要求更改示例中的格式。
示例 1:
yearstart ('19/10/2001')
返回 01/01/2001。
示例 2:
yearstart ('19/10/2001', -1)
返回 01/01/2000。
示例 3:
yearstart ('19/10/2001', 0, 4)
返回 01/04/2001。
示例 4:
将示例脚本添加到文档并运行。然后，至少要将结果列中列出的字段添加到文档中的表格才能查看结果。
以下示例在表格中查找每个发票日期的年份的第一天，其中将该年度的第一个月指定为 4 月。
TempTable:
LOAD RecNo() as InvID, * Inline [
InvDate
28/03/2012
10/12/2012
5/2/2013
31/3/2013
19/5/2013
15/9/2013
11/12/2013
2/3/2014
14/5/2014
13/6/2014
7/7/2014
4/8/2014
];
InvoiceData:
LOAD *,
YearStart(InvDate, 0, 4) AS YrStart
Resident TempTable;
Drop table TempTable;
结果列表包含原始日期和包括 yearstart() 函数的返回值的列。您可以通过在图表属性中指定格式来显示完整的时间戳。
| InvDate | YrStart |
|---|---|
| 28/03/2012 | 01/04/2011 |
| 10/12/2012 | 01/04/2012 |
| 5/2/2013 | 01/04/2012 |
| 31/3/2013 | 01/04/2012 |
| 19/5/2013 | 01/04/2013 |
| 15/9/2013 | 01/04/2013 |
| 11/12/2013 | 01/04/2013 |
| 2/3/2014 | 01/04/2013 |
| 14/5/2014 | 01/04/2014 |
| 13/6/2014 | 01/04/2014 |
| 7/7/2014 | 01/04/2014 |
| 4/8/2014 | 01/04/2014 |
