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)
附註