addmonths - 脚本和图表函数
此函数用于返回在 startdate 后 n 个月内发生的日期,或者如果 n 为负数,则用于返回 startdate 前 n 个月内发生的日期。
语法:
AddMonths(startdate, n , [ , mode])
返回数据类型: 双
addmonths() 函数从 startdate 中加上或减去定义的月数 n,并返回结果日期。
mode 参数将影响当月 28 日当天或之后的 startdate 值。通过将 mode 参数设置为 1,addmonths() 函数将返回一个与月末的相对距离相等的日期作为 startdate。
例如,2 月 28 日是一个月的最后一天。如果 addmonths() 函数(其中 mode 为 1)用于在两个月后返回日期,则函数将返回最后一个日期 4 月 30 日。
参数 | 说明 |
---|---|
startdate | 作为时间戳的开始日期,例如“2012-10-12”。 |
n | 作为正整数或负整数的月份数量。 |
mode | 指定是相对每月的开头还是相对每月的结尾添加月份。对于相对于月份开头的添加,默认模式为 0。为相对于月份末尾的添加将模式设置为 1。当模式设置为 1 时并且输入日期为 28 号或以上时,该功能检查要从开始日期达到月末还剩余多少天。到达月末的相同天数设置在返回的日期上。 |
适用场景
addmonths() 函数通常用于表达式中,以查找一段时间之前或之后的给定月数的日期。
例如,addmonths() 函数可用于识别手机合同的结束日期。
示例 | 结果 |
---|---|
addmonths ('01/29/2003' ,3) | 返回 '04/29/2003'。 |
addmonths ('01/29/2003',3,0) | 返回 '04/29/2003'。 |
addmonths ('01/29/2003',3,1) | 返回 '04/28/2003'。 |
addmonths ('01/29/2003',1,0) | 返回 '02/28/2003'。 |
addmonths ('01/29/2003',1,1) | 返回 '02/26/2003'。 |
addmonths ('02/28/2003',1,0) | 返回 '03/28/2003'。 |
addmonths ('02/28/2003',1,1) | 返回 '03/31/2003'。 |
addmonths ('01/29/2003',-3) | 返回 '10/29/2002'。 |
区域设置
除非另有规定,本主题中的示例使用以下日期格式:MM/DD/YYYY。日期格式已经在数据加载脚本中的 SET DateFormat 语句中指定。由于区域设置和其他因素,系统中的默认日期格式可能有所不同。您可以更改以下示例中的格式以满足您的要求。或者,您可以更改加载脚本中的格式以匹配这些示例。有关详细信息,请参阅修改应用程序和脚本的区域设置。
应用程序中的默认区域设置基于用户配置文件。这些区域格式设置与 Qlik Cloud 用户界面中显示的语言无关。Qlik Cloud 将以与您使用的浏览器相同的语言显示。
如果你是应用程序创建者,你可以为自己创建的应用程序设置默认区域。有关更多信息,请参阅设置 Qlik Cloud 分析 中创建应用程序和脚本所用的首选区域设置。