# inmonthstodate - 脚本和图表函数

此函数用于判断时间戳是否位于截止以及包括 base\_date 的最后毫秒的某个月、两个月、季度、四个月或半年周期的一部分以内。另外，它也可以用于判断时间戳是否位于上一个或下一个时间周期以内。

语法：

InMonths (n\_months, timestamp, base\_date, period\_no[, first\_month\_of\_year ])

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

参数：

InMonthsToDate 参数

| 参数 | 说明 |
| --- | --- |
| n\_months | 用于定义时段的月数。整数或解算为整数的表达式必须为下列之一：1（相当于 inmonth() 函数）、2（两个月）、3（相当于 inquarter() 函数）、4（四个月）或 6（半年）。 |
| timestamp | 想要用来与 base\_date 进行比较的日期。 |
| base\_date | 日期用于计算周期的值。 |
| period\_no | 该周期可通过 period\_no 偏移，其为整数，或解算为整数的表达式，其中值 0 表示该周期包含 base\_date。period\_no 为负数表示前几个时段，为正数则表示随后的几个时段。 |
| first\_month\_of\_year | 如果您不想从一月开始处理（财政）年，可在 first\_month\_of\_year 中指定一个介于 2 和 12 之间的值。 |

示例和结果：

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

示例 1:

`inmonthstodate(4, '25/01/2013', '25/04/2013',   0)`

返回 True。由于 timestamp 的值，25/01/2013 属于 01/01/2013 至 25/04/2013 结束的四个月周期内，其中 base\_date 的值在 25/04/2013 内。

示例 2:

`inmonthstodate(4, '26/04/2013', '25/04/2006',   0)`

返回 False。由于 26/04/2013 在与前面示例相同的周期之外。

示例 3:

`inmonthstodate(4, '25/09/2005', '01/02/2006',   -1)`

返回 True。由于 period\_no 的值，-1 表示将搜索周期向后移动四个月中的其中一个周期（n-months 的值），这可以使搜索周期介于 01/09/2005 至 01/02/2006. 之间

示例 4:

`inmonthstodate(4, '25/04/2006', '01/06/2006',   0, 3)`

返回 True。由于将 first\_month\_of\_year 的值设置为 3，这使得搜索周期介于 01/03/2006 至 01/06/2006 之内，而不是 01/05/2006 至 01/06/2006。

示例 5:

将示例脚本添加到文档并运行。然后，至少要将结果列中列出的字段添加到文档中的表格才能查看结果。

以下示例在表格中检查发票日期是否在两个月周期截止并包括 base\_date 按两个月周期向前移动的一部分内（通过将 period\_no 指定为 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 *,` `InMonthsToDate(2, InvDate, '15/02/2013', 4) AS InMths2DPlus4` `Resident TempTable;`

`Drop table TempTable;`

结果列表包含原始日期和包括 InMonths() 函数的返回值的列。

搜索周期介于 01/09/2013 至 15/10/2013 之间，因为 base\_date 的值从函数中的值 (15/02/2013) 开始向前移动八个月。

示例 5 结果

| InvDate | InMths2DPlus4 |
| --- | --- |
| 28/03/2012 | 0 (False) |
| 10/12/2012 | 0 (False) |
| 5/2/2013 | 0 (False) |
| 31/3/2013 | 0 (False) |
| 19/5/2013 | 0 (False) |
| 15/9/2013 | -1 (True) |
| 11/12/2013 | 0 (False) |
| 2/3/2014 | 0 (False) |
| 14/5/2014 | 0 (False) |
| 13/6/2014 | 0 (False) |
| 7/7/2014 | 0 (False) |
| 4/8/2014 | 0 (False) |