跳到主要内容

monthsname - 脚本和图表函数

此函数用于返回一个显示值,表示时段各月份(根据 MonthNames 脚本变量的格式)和年的范围。基础数值与包含基准日期的一个月、两个月、季度、四个月期间或半年的第一毫秒的时间戳对应。

语法:  

MonthsName(n_months, date[, period_no[, first_month_of_year]])

返回数据类型:

monthsname 函数的图表

示例图显示给定特定的输入日期时 monthsname 函数返回的月份范围。

monthsname() 函数根据提供的 n_months 参数将一年划分为若干段。然后,它评估每个提供的 date 所属的段,并返回该段的开始和结束月份名称以及年份。该函数还提供了从前面或后面的段返回这些边界的能力,以及重新定义一年中的第一个月的能力。

函数中提供了一年中的以下时段作为 n_month 参数:

可能的 n_month 参数
期间 月数
1
双月 2
3
四个月

4

半年 6
参数
参数 描述
n_months 用于定义时段的月数。整数或解算为整数的表达式必须为下列之一:1(相当于 inmonth() 函数)、2(两个月)、3(相当于 inquarter()函数)、4(四个月期间)或 6(半年)。
date 要求值的日期。
period_no 该周期可通过 period_no 偏移,其为整数,或解算为整数的表达式,其中值 0 表示该周期包含 base_dateperiod_no 为负数表示前几个时段,为正数则表示随后的几个时段。
first_month_of_year

如果您不想从一月开始处理(财政)年,可在 first_month_of_year 中指定一个介于 2 和 12 之间的值。

适用场景

当您希望向用户提供按其选择的时间段比较聚合的功能时,monthsname() 函数非常有用。例如,您可以提供一个输入变量,让用户查看每月、季度或半年的产品总销售额。

可以在加载脚本中创建这些维度,方法是将函数作为主日历表中的字段添加,或者直接在图表中创建维度作为计算维度。

函数示例
Example 结果
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 Cloud 用户界面中显示的语言无关。Qlik Cloud 将以与您使用的浏览器相同的语言显示。

如果你是应用程序创建者,你可以为自己创建的应用程序设置默认区域。有关更多信息,请参阅设置创建应用程序所用的首选区域设置

示例 1 – 基本示例

示例 2 – period_no

示例 3 – first_month_of_year

示例 4 – 图表对象

示例 5 – 场景