inmonths - 脚本和图表函数
此函数用于判断时间戳是否位于作为基准日期的同一个月、两个月、季度、四个月或半年以内。另外,也可以用于判断时间戳是否位于上一个或下一个时间周期以内。
语法:
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 语句中指定。可以根据要求更改示例中的格式。
脚本示例
inmonths(4, '25/01/2013', '25/04/2013', 0)
|
返回 True。由于 timestamp 的值,25/01/2013 属于 01/01/2013 至 30/04/2013 的四个月周期内,其中 base_date 的值在 25/04/2013 内。 |
inmonths(4, '25/05/2013', '25/04/2013', 0)
|
返回 False。由于 25/05/2013 在与前面示例相同的周期之外。 |
inmonths(4, '25/11/2012', '01/02/2013', -1 )
|
返回 True。由于 period_no 的值,-1 表示将搜索周期向后移动四个月中的其中一个周期(n-months 的值),这可以使搜索周期介于 01/09/2012 至 31/12/2012. 之间 |
inmonths( 4, '25/05/2006', '01/03/2006', 0, 3)
|
返回 True。由于将 first_month_of_year 的值设置为 3,这使得搜索周期介于 01/03/2006 至 30/07/2006 之内,而不是 01/01/2006 至 30/04/2006。 |
示例:
将示例脚本添加到应用程序并运行。要查看结果,将结果列中列出的字段添加到应用程序中的工作表。
以下示例在表格中检查发票日期是否在 base_date 按一个两个月周期向前移动的两个月周期内(通过将 period_no 指定为 1)。
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 *,
InMonths(2, InvDate, '11/02/2013', 1) AS InMthsPlus1
Resident TempTable;
Drop table TempTable;
结果列表包含原始日期和包括 InMonths() 函数的返回值的列。
搜索周期介于 01/03/2013 至 30/04/2013 之间,因为 base_date 的值从函数中的值 (11/02/2013) 开始向前移动两个月。
结果表
InvDate |
InMthsPlus1 |
28/03/2012 |
0 (False) |
10/12/2012 |
0 (False) |
5/2/2013 |
0 (False) |
31/3/2013 |
-1 (True) |
19/5/2013 |
0 (False) |
15/9/2013 |
0 (False) |
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) |