跳到主要内容

weekname - 脚本和图表函数

此函数用于返回一个值,显示带有与包含 date 的周的第一天的第一毫秒时间戳对应的基本数值对应的年份和周数。

语法:  

WeekName(date[, period_no[,first_week_day]])

weekname() 函数确定日期属于哪一周,并返回该周的周数和年份。一周的第一天由 FirstWeekDay系统变量确定。但是,您可以使用 weekname() 函数中的 first_week_day 参数更改将哪个月设置为第一个月。

默认情况下,Qlik Sense应用程序使用断周(由 BrokenWeeks 系统变量定义),因此周数计数从 1 月 1 日开始,并在 FirsWeekDay 系统变量前一天结束,而不管发生了多少天。

weekname 函数的图表。

显示 weekname 函数可用于设置的年和周范围的图表。

但是,如果您的应用程序使用的是连续的周,则第 1 周可以从上一年开始,也可以从 1 月的前几天开始。这取决于如何使用 ReferenceDayFirstWeekDay 系统变量。

当您希望按周比较聚合时,weekname() 函数非常有用。

例如,如果您想查看每周产品的总销售额。要保持与应用程序中 BrokenWeeks系统变量的一致性,请使用 weekname() 而不是 lunarweekname()。如果应用程序使用不间断的周,则第 1 周可能包含上一年 12 月的日期,也可能不包括本年 1 月的日期。如果应用程序使用的是中断周,则第 1 周可能少于 7 天。

返回数据类型:

参数
参数 说明
date 要求值的日期。
period_no shift 为整数,其中值 0 表示该星期包含 date。shift 为负数,表示前几星期,正数表示随后的几星期。
first_week_day

指定一周的开始日期。如果忽略,使用 FirstWeekDay 变量的值。

FirstWeekDay

可以使用以下值在 first_week_day 参数中设置一周开始的日期:

first_week_day 值
星期一 0
星期二 1
星期三 2
星期四 3
星期五 4
星期六 5
星期日 6

区域设置

除非另有规定,本主题中的示例使用以下日期格式:MM/DD/YYYY。日期格式已经在数据加载脚本中的 SET DateFormat 语句中指定。由于区域设置和其他因素,系统中的默认日期格式可能有所不同。您可以更改以下示例中的格式以满足您的要求。或者,您可以更改加载脚本中的格式以匹配这些示例。有关详细信息,请参阅修改应用程序区域设置

应用程序中的默认区域设置基于身份提供商设置、系统设置或浏览器设置的组合。这些区域格式设置与 Qlik Cloud 用户界面中显示的语言无关。Qlik Cloud 将以与您使用的浏览器相同的语言显示。

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

函数示例
Example 结果
weekname('01/12/2013') 返回 2013/02。
weekname('01/12/2013', -1) 返回 2013/01。
weekname('01/12/2013', 0, 1) 返回 2013/02。

示例 1 – 没有其他参数的日期

示例 2 – period_no

示例 3 – first_week_day

示例 4 – 图表对象

示例 5 – 场景