注意
不建議將此函式用於 視覺計算 ，因為它可能會傳回毫無意義的結果。
對於日期欄輸入，會傳回指定日期欄目前內容中年份的第一個日期。
對於行事曆輸入，傳回目前內容中一年中第一個日期的資料表。 表格包含所有主要標記欄和所有時間相關欄。
語法
STARTOFYEAR(<dates> or <calendar>)
參數
| 詞彙 | 定義 |
|---|---|
dates or calendar |
包含日期或行事曆參照的資料行。 |
YearEndDate |
（選擇性）年終日期值。 僅適用於日期欄輸入。 |
傳回值
對於日期欄輸入，包含具有日期值的單欄和單列的表格。
對於行事曆輸入，目前內容中一年中第一個日期的表格。 表格包含所有主要標記欄和所有時間相關欄。
備註
dates自變數可以是下列任一項：- 日期/時間數據行的參考。
- 傳回日期/時間值單一數據行的數據表運算式。
- 布爾表示式，定義日期/時間值的單一數據行數據表。
布林運算式的條件約束會在 主題中說明，CALCULATE。
使用行事曆時，不得指定參數
year_end_date。在匯出數據行或數據列層級安全性 （RLS） 規則中使用時，不支援在 DirectQuery 模式中使用此函式。
範例
下列範例公式會針對目前的內容，建立傳回年份開始的量值。
= STARTOFYEAR(DateTime[DateKey])
行事曆型時間智慧範例
下列範例公式會建立資料表，以傳回會計行事曆的年始標記資料行。
= STARTOFYEAR(FiscalCalendar)