注意
不建議將此函式用於 視覺計算,因為它可能會傳回毫無意義的結果。
對於日期欄輸入,傳回一個表格,其中包含目前內容中年初至今日期的欄。
對於行事曆輸入,在目前內容中傳回年初至今的資料表。 表格包含所有主要標記欄和所有時間相關欄。
語法
DATESYTD(<dates> or <calendar> [,<year_end_date>])
參數
| 術語 | 定義 |
|---|---|
dates or calendar |
包含日期或行事曆參照的資料行。 |
year_end_date |
(選擇性)具有定義年終日期之日期的常值字串。 預設值為 12 月 31 日。 只有在使用日期直欄語法時,才允許使用此參數。 |
傳回值
對於日期欄輸入,包含單欄日期值的資料表。
對於行事曆輸入,包含所有主要標記欄和所有時間相關欄的表格。
言論
dates 自變數可以是下列任一項:
日期/時間數據行的參考,
傳回日期/時間值單一數據行的數據表運算式,
布爾表示式,定義日期/時間值的單一數據行數據表。
注意
布林運算式的條件約束會在 主題中說明,CALCULATE 函式。
year_end_date參數是日期的字串常值,與建立活頁簿之用戶端的地區設定相同。 會忽略日期的年份部分。 視地區設定而定,格式可能類似 「m-dd」 或 「dd-m」。只有在使用日期直欄語法時,才允許使用參數
year_end_date。在匯出數據行或數據列層級安全性 (RLS) 規則中使用時,不支援在 DirectQuery 模式中使用此函式。
例
下列範例公式會建立量值,以計算因特網銷售的「執行總計」。
= CALCULATE (
SUM ( InternetSales_USD[SalesAmount_USD] ),
DATESYTD ( DateTime[DateKey] )
)
下列範例公式會建立一個量值,此量值會使用美國地區設定來計算因特網銷售的「會計年度執行總計」,以取得日期格式。
= CALCULATE(
SUM(InternetSales_USD[SalesAmount_USD]),
DATESYTD(DateTime[DateKey],
"6-30"
)
)
行事曆型時間智慧範例
下列範例公式會建立一個量值,以計算會計行事曆中網際網路銷售的「執行總計」。
= CALCULATE (
SUM ( InternetSales_USD[SalesAmount_USD] ),
DATESYTD ( FiscalCalendar )
)