跳到主要内容

yearend - 脚本和图表函数

此函数用于返回与包含 date 的年份的最后一天的最后毫秒时间戳对应的值。默认的输出格式为在脚本中所设置的 DateFormat

语法:  

YearEnd( date[, period_no[, first_month_of_year = 1]])

换句话说,yearend() 函数确定日期属于哪一年。然后以日期格式返回该年最后一毫秒的时间戳。默认情况下,一年的第一个月是一月。但是,您可以使用 yearend() 函数中的 first_month_of_year 参数更改将哪个月设置为第一个月。

信息注释 yearend() 函数不考虑 FirstMonthOfYear 系统变量。这一年从 1 月 1 日开始,除非用 first_month_of_year 参数来改变它。

yearend() 函数的图表。

显示 yearend() 函数如何识别日期和发生它的年份的末尾的图表。

当您希望计算使用尚未发生的年份分数时,yearend() 函数将用作表达式的一部分。例如,您想计算一年中尚未发生的利息总额。

返回数据类型:

参数
参数 描述
date 要求值的日期。
period_no period_no 为整数,其中值 0 表示该年份包含 dateperiod_no 为负数表示前几年,为正数表示随后几年。
first_month_of_year 如果您不想从一月开始处理(财政)年,可在 first_month_of_year 中指定一个介于 2 和 12 之间的值。

可以使用以下值在 first_month_of_year 参数中设置一年中的第一个月:

first_month_of_year 值
二月 2
三月 3
四月 4
五月 5
六月 6
七月 7
八月 8
九月 9
十月 10
十一月 11
十二月 12

区域设置

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

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

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

函数示例
Example 结果
yearend('10/19/2001') Returns 12/31/2001 23:59:59.
yearend('10/19/2001', -1) Returns 12/31/2000 23:59:59.
yearend('10/19/2001', 0, 4) Returns 03/31/2002 23:59:59.

示例 1 – 没有其他参数

示例 2 – period_no

示例 3 – first_month_of_year

示例 4 – 图表对象

示例 5 – 场景