跳到主要内容 跳到补充内容

addmonths - 脚本和图表函数

此函数用于返回在 startdaten 个月内发生的日期,或者如果 n 为负数,则用于返回 startdaten 个月内发生的日期。

语法:  

AddMonths(startdate, n , [ , mode])

返回数据类型:

addmonths() 函数从 startdate 中加上或减去定义的月数 n,并返回结果日期。

mode 参数将影响当月 28 日当天或之后的 startdate 值。通过将 mode 参数设置为 1,addmonths() 函数将返回一个与月末的相对距离相等的日期作为 startdate

addmonths() 函数的示例图表

示例图表显示了 addmonths 函数的各个分量如何组合在一起生成输出日期。

例如,2 月 28 日是一个月的最后一天。如果 addmonths() 函数(其中 mode 为 1)用于在两个月后返回日期,则函数将返回最后一个日期 4 月 30 日。

addmonths() 函数的示例图表,具有 mode=1

示例图显示了如何更改“mode”参数以更改 addmonths 函数的输出日期。
参数
参数 说明
startdate 作为时间戳的开始日期,例如“2012-10-12”。
n 作为正整数或负整数的月份数量。
mode 指定是相对每月的开头还是相对每月的结尾添加月份。对于相对于月份开头的添加,默认模式为 0。为相对于月份末尾的添加将模式设置为 1。当模式设置为 1 时并且输入日期为 28 号或以上时,该功能检查要从开始日期达到月末还剩余多少天。到达月末的相同天数设置在返回的日期上。

适用场景

addmonths() 函数通常用于表达式中,以查找一段时间之前或之后的给定月数的日期。

例如,addmonths() 函数可用于识别手机合同的结束日期。

函数示例
Example 结果
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 Sense 的计算机或服务器的区域系统设置。如果您访问的 Qlik Sense 服务器设置为瑞典,则数据加载编辑器将使用瑞典地区设置的日期、时间和货币。这些区域格式设置与 Qlik Sense 用户界面中显示的语言无关。Qlik Sense 将以与您使用的浏览器相同的语言显示。

示例 1 – 没有其他参数

示例 2 – 相对月末

示例 3 – 图表对象示例

示例 4 – 场景

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!