日期
以日期時間格式傳回指定的日期。
語法
DATE(<year>, <month>, <day>)
參數
| 詞彙 | 定義 |
|---|---|
| year | 代表年份的數字。 year 引數的值可包含一到四位數字。 year 引數會根據電腦所使用的日期系統轉譯。 支援從 1900 年 3 月 1 日開始的日期。 如果輸入有小數位數的數字，該數字即會四捨五入。 如果是大於 9999 或小於零 (負數值) 的值，此函數會傳回 #VALUE! 錯誤。 如果 year 值介於 0 到 1899 之間，則該值會新增至 1900 以產生最終值。 請參閱以下範例。 注意：針對 year 引數應該盡可能使用四位數，以防止不想要的結果。 例如，使用 07 傳回的 year 值為 1907。 |
| 個月 | 代表月份的數字，或根據下列規則的計算： 不支援負整數。 有效值為 1-12。 如果 month 是 1 到 12 的數字，則代表一年中的某一個月。 1 代表一月、2代表二月，依此類推，一直到 12 代表十二月。 如果輸入大於 12 的整數，即會發生下列計算：將 month 的值加上 year 計算日期。 例如，DATE( 2008, 18, 1) 函式會傳回相當於 2009 年 6 月 1 日的日期時間值，因為 2008 年開頭加上 18 個月，會得出 2009 年 6 月的值。 請參閱以下的範例。 |
| 天 | 代表日的數字，或根據下列規則的計算： 不支援負整數。 有效值為 1-31。 如果 day 是從 1 到指定月份最後一天的數字，即表示該月份的某一天。 如果輸入大於指定月份最後一天的整數，即會發生下列計算：將 day 的值加上 month 計算日期。 例如，在公式 DATE( 2008, 3, 32) 中，DATE 函式會傳回相當於 2008 年 4 月 1 日的日期時間值，因為 3 月開頭加上 32 天會得出 4 月 1 日的值。如果 day 包含小數部分，則會四捨五入為最接近的整數值。 |
傳回值
傳回指定的日期 (日期時間)。
備註
DATE 函式採用輸入的整數當作引數，並產生對應的日期。 DATE 函式在年、月和日都由公式提供時最有用。 例如，基礎資料可能包含無法識別為日期的日期格式，例如 YYYYMMDD。 您可以使用 DATE 函式結合其他函式，將日期轉換為可識別為日期的數字。
相較於將日期儲存為序號的 Microsoft Excel，DAX 的日期函式一律會傳回日期時間資料類型。 不過，如果您想要，也可以使用格式將日期顯示為序號。
日期和日期時間也可以指定為常值，格式為
dt"YYYY-MM-DD"、dt"YYYY-MM-DDThh:mm:ss"或dt"YYYY-MM-DD hh:mm:ss"。 當指定為常值時，不需要在運算式中使用 DATE 函式。 若要深入了解，請參閱 DAX 語法 | 日期和時間。在計算結果欄或資料列層級安全性 (RLS) 規則中使用時，不支援在 DirectQuery 模式中使用此函式。
範例
簡單 DATE
下列公式會傳回 2009 年 6 月 8 日的日期：
= DATE(2009,7,8)
1899 之前的年份
如果您為 year 引數輸入的值介於 0 (零) 和 1899 (含) 之間，則該值會加上 1900 以計算年。 下列公式會傳回 1908 年 1 月 2 日：(1900+08)。
= DATE(08,1,2)
1899 之後的年份
如果 year 介於1900 和 9999 (含) 之間，則該值會作為年使用。 下列公式會傳回 2008 年 1 月 2 日：
= DATE(2008,1,2)
月
如果 month 大於 12，則 month 會用指定年份的第一個月加上該月數。 下列公式會傳回 2009 年 2 月 2 日的日期：
= DATE(2008,14,2)
天
如果 day 大於指定月份的天數，則 day 會用該月的第一天加上該天數。 下列公式會傳回 2008 年 2 月 4 日的日期：
= DATE(2008,1,35)