共用方式為


DATE 函數 (DAX)

以 datetime 格式傳回指定的日期。

語法

DATE(<year>, <month>, <day>)

參數

詞彙

定義

year

代表年的數字。

year 引數的值可以包含一至四位數。year 引數會根據您電腦所使用的日期系統進行解譯。

支援從 1990 年 3 月 1 日開始的日期。

如果您輸入的數字有小數位數,則會四捨五入該數字。

如果是大於 9999 或小於零 (負數值) 的值,此函數會傳回 #VALUE! 錯誤。

如果 year 值介於 0 與 1899 之間,此值會加入到 1900 來產生最後的值。請參閱以下的範例。

附註附註
您應該盡可能使用四位數表示 year 引數來避免非預期的結果。例如,使用 07 會傳回 1907 做為 year 值。

month

表示月份的數字或是根據下列規則的計算:

如果 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,PowerPivot 日期函數永遠會傳回 datetime 資料類型。不過,如果您需要,可以使用格式將日期顯示為數列數字。

範例:傳回簡單的日期

描述

下列公式會傳回 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)