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() 函数将用作表达式的一部分。例如,您想计算一年中尚未发生的利息总额。
返回数据类型: 双
参数 | 说明 |
---|---|
date | 要评估的日期或时间戳。 |
period_no | period_no 为整数,其中值 0 表示该年份包含 date。period_no 为负数表示前几年,为正数表示随后几年。 |
first_month_of_year | 如果您不想从一月开始处理(财政)年,可在 first_month_of_year 中指定一个介于 2 和 12 之间的值。 |
可以使用以下值在 first_month_of_year 参数中设置一年中的第一个月:
月 | 值 |
---|---|
二月 | 2 |
三月 | 3 |
四月 | 4 |
五月 | 5 |
六月 | 6 |
七月 | 7 |
八月 | 8 |
九月 | 9 |
十月 | 10 |
十一月 | 11 |
十二月 | 12 |
区域设置
除非另有规定,本主题中的示例使用以下日期格式:MM/DD/YYYY。日期格式已经在数据加载脚本中的 SET DateFormat 语句中指定。由于区域设置和其他因素,系统中的默认日期格式可能有所不同。您可以更改以下示例中的格式以满足您的要求。或者,您可以更改加载脚本中的格式以匹配这些示例。
应用程序中的默认区域设置基于安装 Qlik Sense 的计算机或服务器的区域系统设置。如果您访问的 Qlik Sense 服务器设置为瑞典,则数据加载编辑器将使用瑞典地区设置的日期、时间和货币。这些区域格式设置与 Qlik Sense 用户界面中显示的语言无关。Qlik Sense 将以与您使用的浏览器相同的语言显示。
示例 | 结果 |
---|---|
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. |