注意
不建议在视觉对象计算中使用此函数，因为它可能会返回无意义的结果。
对于日期列输入，返回指定日期列的当前上下文中年份的第一个日期。
对于日历输入，在当前上下文中返回年份的第一个日期的表。 该表包含所有主标记列和所有时间相关列。
语法
STARTOFYEAR(<dates> or <calendar>)
parameters
| 术语 | 定义 |
|---|---|
dates or calendar |
包含日期或日历引用的列。 |
YearEndDate |
（可选）年结束日期值。 仅适用于日期列输入。 |
返回值
对于日期列输入，包含单个列和具有日期值的单个行的表。
对于日历输入，当前上下文中年份的第一个日期的表。 该表包含所有主标记列和所有时间相关列。
备注
dates参数可以是以下任一参数：- 对日期/时间列的引用。
- 返回日期/时间值的单个列的表表达式。
- 一个布尔表达式，用于定义日期/时间值的单列表。
主题 CALCULATE介绍了对布尔表达式的约束。
year_end_date使用日历时，不得指定参数。在计算列或行级别安全性 （RLS） 规则中使用时，不支持在 DirectQuery 模式下使用此函数。
示例
以下示例公式创建一个度量值，该度量值返回当前上下文的年初。
= STARTOFYEAR(DateTime[DateKey])
基于日历的时间智能示例
以下示例公式创建一个表，该表返回与会计日历的年初对应的标记列。
= STARTOFYEAR(FiscalCalendar)