monthsname - 脚本和图表函数
此函数用于返回一个显示值,表示时段各月份(根据 MonthNames 脚本变量的格式)和年的范围。基础数值与包含基准日期的一个月、两个月、季度、四个月期间或半年的第一毫秒的时间戳对应。
语法:
MonthsName(n_months, date[, period_no[, first_month_of_year]])
返回数据类型: 双
monthsname() 函数根据提供的 n_months 参数将一年划分为若干段。然后,它评估每个提供的 date 所属的段,并返回该段的开始和结束月份名称以及年份。该函数还提供了从前面或后面的段返回这些边界的能力,以及重新定义一年中的第一个月的能力。
函数中提供了一年中的以下时段作为 n_month 参数:
期间 | 月数 |
---|---|
月 | 1 |
双月 | 2 |
季 | 3 |
四个月 |
4 |
半年 | 6 |
参数 | 说明 |
---|---|
n_months | 用于定义时段的月数。整数或解算为整数的表达式必须为下列之一:1(相当于 inmonth() 函数)、2(两个月)、3(相当于 inquarter()函数)、4(四个月期间)或 6(半年)。 |
date | 要评估的日期或时间戳。 |
period_no | 该周期可通过 period_no 偏移,其为整数,或解算为整数的表达式,其中值 0 表示该周期包含 base_date。period_no 为负数表示前几个时段,为正数则表示随后的几个时段。 |
first_month_of_year |
如果您不想从一月开始处理(财政)年,可在 first_month_of_year 中指定一个介于 2 和 12 之间的值。 |
适用场景
当您希望向用户提供按其选择的时间段比较聚合的功能时,monthsname() 函数非常有用。例如,您可以提供一个输入变量,让用户查看每月、季度或半年的产品总销售额。
可以在加载脚本中创建这些维度,方法是将函数作为主日历表中的字段添加,或者直接在图表中创建维度作为计算维度。
示例 | 结果 |
---|---|
monthsname(4, '10/19/2013') | 返回 'Sep-Dec 2013' 。因为在此例和其他示例中,已将 SET Monthnames 语句设置为 Jan;Feb;Mar,以此类推。 |
monthsname(4, '10/19/2013', -1) | 返回 'May-Aug 2013'。 |
monthsname(4, '10/19/2013', 0, 2) | 返回 'Oct-Jan 2014',因为指定年从月份 2 开始。因此,四个月期在次年的第一个月结束。 |
区域设置
除非另有规定,本主题中的示例使用以下日期格式:MM/DD/YYYY。日期格式已经在数据加载脚本中的 SET DateFormat 语句中指定。由于区域设置和其他因素,系统中的默认日期格式可能有所不同。您可以更改以下示例中的格式以满足您的要求。或者,您可以更改加载脚本中的格式以匹配这些示例。
应用程序中的默认区域设置基于安装 Qlik Sense 的计算机或服务器的区域系统设置。如果您访问的 Qlik Sense 服务器设置为瑞典,则数据加载编辑器将使用瑞典地区设置的日期、时间和货币。这些区域格式设置与 Qlik Sense 用户界面中显示的语言无关。Qlik Sense 将以与您使用的浏览器相同的语言显示。