跳到主要内容 跳到补充内容

yearstart - 脚本和图表函数

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

语法:  

YearStart(date[, period_no[, first_month_of_year]])

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

yearstart() 函数的图表,显示函数可以覆盖的时间范围。

显示 yearstart() 函数的图表,该函数标识给定年份期间内的日期,并返回属于该给定年份的日期的年初时间戳。

当您希望计算使用目前已经过的年份分数时,yearstart() 函数将用作表达式的一部分。例如,如果您要计算年初至今累计的利息。

返回数据类型:

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

以下月份可用于 first_month_of_year argument

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

区域设置

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

应用程序中的默认区域设置基于用户配置文件。这些区域格式设置与 Qlik Cloud 用户界面中显示的语言无关。Qlik Cloud 将以与您使用的浏览器相同的语言显示。

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

函数示例
示例 结果
yearstart('10/19/2001') Returns 01/01/2001 00:00:00.
yearstart('10/19/2001',-1) Returns 01/01/2000 00:00:00.
yearstart('10/19/2001',0,4) Returns 04/01/2001 00:00:00.

示例 1 – 基本示例

示例 2 – period_no

示例 3 – first_month_of_year

示例 4 – 图表对象

示例 5 – 场景

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!