# weekend - 脚本和图表函数

此函数用于返回与包含 date 的日历周的最后一天（周日）的最后一毫秒时间戳对应的值。默认的输出格式为在脚本中所设置的 DateFormat。

语法：

WeekEnd(date [, period\_no = 0 [, first\_week\_day=0]])

**返回数据类型：**双

参数：

WeekEnd 参数

| 参数 | 说明 |
| --- | --- |
| date | 要求值的日期。 |
| period\_no | shift 为整数，其中值 0 表示该星期包含 date。shift 为负数，表示前几星期，正数表示随后的几星期。 |
| first\_week\_day | 如果不指定 first\_week\_day，则变量 FirstWeekDay 的值将用作一周的第一天。<br><br>如果要使用其他天作为一周的第一天，请将 first\_week\_day 设置为：<br><br><ul> <li>0，表示周一</li> <li>1，表示周二</li> <li>2，表示周三</li> <li>3，表示周四</li> <li>4，表示周五</li> <li>5，表示周六</li> <li>6，表示周日</li> </ul><br><br>此函数返回的整数现在将使用您使用 first\_week\_day 设置的一周的第一天作为基数 (0)。 |

示例和结果：

以下示例使用日期格式 DD/MM/YYYY。日期格式已经在加载脚本顶部的 SET DateFormat 语句中指定。可以根据要求更改示例中的格式。

示例 1:

`weekend('10/01/2013')`

返回 12/01/2013 23:59:59。

示例 2:

`weekend('10/01/2013', -1)`

返回 06/01/2013 23:59:59.

示例 3:

`weekend('10/01/2013', 0, 1)`

返回 14/01/2013 23:59:59。

示例 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 *,` `WeekEnd(InvDate, 1) AS WkEnd` `Resident TempTable;`

`Drop table TempTable;`

结果列表包含原始日期和包括 weekend() 函数的返回值的列。您可以通过在图表属性中指定格式来显示完整的时间戳。

示例 4 结果

| InvDate | WkEnd |
| --- | --- |
| 28/03/2012 | 08/04/2012 |
| 10/12/2012 | 23/12/2012 |
| 5/2/2013 | 17/02/2013 |
| 31/3/2013 | 07/04/2013 |
| 19/5/2013 | 26/05/2013 |
| 15/9/2013 | 22/09/2013 |
| 11/12/2013 | 22/12/2013 |
| 2/3/2014 | 09/03/2014 |
| 14/5/2014 | 25/05/2014 |
| 13/6/2014 | 22/06/2014 |
| 7/7/2014 | 20/07/2014 |
| 4/8/2014 | 17/08/2014 |