DATE 函式
以 datetime 格式傳回指定的日期。
語法
DATE(<year>, <month>, <day>)
參數
詞彙 |
定義 |
|---|---|
year |
代表年的數字。 year 引數的值可以包含一至四位數。 year 引數會根據您電腦所使用的日期系統進行解譯。 支援從 1990 年 3 月 1 日開始的日期。 如果您輸入的數字有小數位數，則會四捨五入該數字。 如果是大於 9999 或小於零 (負數值) 的值，此函數會傳回 #VALUE! 錯誤。 如果 year 值介於 0 與 1899 之間，此值會加入到 1900 來產生最後的值。 請參閱以下的範例。
|
month |
表示月份的數字或是根據下列規則的計算： 如果月份是從 1 到 12 的一個數字，則它會表示該年度的某個月份。 1 表示一月、2 表示二月，依此類推，最後是 12 表示十二月。 如果您輸入大於 12 的整數，將會發生下列運算：將 month 的值加入到 year 來計算日期。 例如，如果您有 DATE( 2008, 18, 1)，此函數會傳回相當於 2009 年 6 月 1 日的日期時間值，因為在 2008 年的開頭加入了 18 個月，所以產生 2009 年 6 月的值。 請參閱底下的範例。 如果您輸入負整數，就會發生下列計算：從 year 中減去 month 的值來計算日期。 例如，如果您有 DATE( 2008, -6, 15)，此函數會傳回相當於 2007 年 6 月 15 日的日期時間值，因為從 2008 年的開頭減去 6 個月，所以產生 2007 年 6 月的值。 請參閱底下的範例。 |
day |
表示日的數字或是根據下列規則的計算： 如果 day 是從 1 到給定月份之最後一天的數字，則它會表示該月份的某個日。 如果您輸入的整數大於給定月份的最後一天，則會發生下列計算：將 day 的值加入到 month 來計算日期。 例如，在 DATE( 2008, 3, 32) 公式中，DATE 函數會傳回相當於 2008 年 4 月 1 日的 datetime 值，因為在 3 月的開頭加入了 32 天，所以產生 4 月 1 日的值。 如果您輸入負整數，就會發生下列計算：從 month 中減去 day 的值來計算日期。 例如，在 DATE( 2008, 5, -15) 公式中，DATE 函數會傳回相當於 2008 年 4 月 15 日的 datetime 值，因為從 2008 年 5 月的開頭減去 15 天，所以產生 2008 年 4 月的值。 如果 day 包含小數部分，則會將它四捨五入到最接近的整數值。 |
傳回值
傳回指定的日期 (datetime))。
備註
DATE 函數會採用當做引數輸入的整數，然後產生對應的日期。 當公式提供年、月和日時，DATE 函數最有用。 例如，基礎資料可能包含無法辨識為日期之格式的日期，例如 YYYYMMDD。 您可以使用 DATE 函數搭配其他函數，將日期轉換為可以辨識為日期的數字。
相較於將日期儲存為數列數字的 Microsoft Excel，DAX 日期函數永遠會傳回 datetime 資料類型。 不過，如果您需要，可以使用格式將日期顯示為數列數字。
在以 DirectQuery 模式部署然後查詢的模型中使用時，此 DAX 函數可能會傳回不同的結果。 如需有關 DirectQuery 模式語意差異的詳細資訊，請參閱 https://go.microsoft.com/fwlink/?LinkId=219171。
範例：傳回簡單的日期
說明
下列公式會傳回 2009 年 7 月 8 日這個日期：
程式碼
=DATE(2009,7,8)
範例：1899 前的年份
說明
如果您針對 year 引數所輸入的值介於 0 (零) 和 1899 (包含) 之間，計算年份時會將該值加上 1900。 下列公式會傳回 1908 年 1 月 2 日：(1900+08)。
程式碼
=DATE(08,1,2)
範例：1899 前的年份
說明
如果您針對 year 引數所輸入的值介於 0 (零) 和 1899 (包含) 之間，計算年份時會將該值加上 1900。 下列公式會傳回 3700 年 1 月 2 日：(1900+1800)。
程式碼
=DATE(1800,1,2)
範例：1899 後的年份
說明
如果 year 介於 1900 和 9999 (包含) 之間，該值會當做年份使用。 下列公式會傳回 2008 年 1 月 2 日：
程式碼
=DATE(2008,1,2)
範例：處理月份
說明
如果 month 大於 12，month 會將該月數加到所指定之年份的第一個月。 下列公式會傳回 2009 年 2 月 2 日這個日期：
程式碼
=DATE(2008,14,2)
註解
如果 month 值小於 1，DATE 函數會減去該月數的大小，然後從指定之年份的第一個月加 1。 下列公式會傳回 2007 年 9 月 2 日。
=DATE(2008,-3,2)
範例：處理天數
說明
如果 day 大於指定之月份的天數，day 會將該天數加到該月份的第一天。 下列公式會傳回 2008 年 2 月 4 日這個日期：
程式碼
=DATE(2008,1,35)
註解
如果 day 小於 1，day 會減去該天數的大小，然後從指定之月份的第一天加 1。 下列公式會傳回 2007 年 12 月 16 日：
=DATE(2008,1,-15)