inmonthstodate - 脚本和图表函数
此函数用于判断时间戳是否位于截止以及包括 base_date 的最后毫秒的某个月、两个月、季度、四个月或半年周期的一部分以内。另外,它也可以用于判断时间戳是否位于上一个或下一个时间周期以内。
语法:
InMonths (n_months, timestamp, base_date, period_no[, first_month_of_year ])
返回数据类型:布尔值
参数:
参数 | 说明 |
---|---|
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) 开始向前移动八个月。
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) |