DATE

适用于:计算列计算表度量值视觉对象计算

以日期/时间格式返回指定的日期 。

语法

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

parameters

术语 定义
年份 表示年份的数字。

“year”参数的值可以包含一到四位数字 。 根据计算机使用的日期系统解释“year”参数 。

支持从 1900 年 3 月 1 日开始的日期。

如果输入的数字有小数位,则对该数字执行舍入。

对于大于 9999 或小于零(负值)的值,该函数将返回 #VALUE! 错误。

如果“年份”值介于 0 和 1899 之间,则该值将与 1900 相加以生成最终值 。 请参下面的示例。 注意: 应尽可能使用四位数的“year”参数,以防止出现意外的结果 。 例如,使用 07 返回 1907 作为年份值。
月份 表示月份的数字或根据下列规则执行的计算:

不支持负整数。 有效值为 1-12。

如果“月份”是从 1 到 12 的数字,则表示一年中的某个月。 1 代表一月,2 表示二月份,依此类推,直到 12 表示十二月。

如果你输入一个大于 12 的整数,则会进行以下计算:通过将“月份”的值与“年份”相加来计算日期。 例如,如果你有函数 DATE( 2008, 18, 1),该函数将返回一个相当于 2009 年 6 月 1 日的日期时间值,因为在 2008 年初增加了 18 个月,得到一个 2009 年 6 月的值。 请参阅以下示例。
day 表示日期的数字或根据以下规则执行的计算:

不支持负整数。 有效值为 1-31。

如果“日期”是 1 到给定月份最后一天中的某个数字,则它表示该月中的某一天

如果输入的整数大于给定月份的最后一天,则会进行以下计算:通过将“日期”的值与“月份”相加来计算日期。 例如,在公式 DATE( 2008, 3, 32) 中,DATE 函数将返回相当于 2008 年 4 月 1 日的“日期时间”值,因为将三月初加上 32 天,得到一个 4 月 1 日的值

如果“日期”包含小数部分,则会将其舍入到最接近的整数值

返回值

返回指定日期(“日期时间”)

备注

  • 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 模式下使用此函数。

示例

简单日期

以下公式返回日期 2009 年 7 月 8 日:

= DATE(2009,7,8)  

1899 年之前的年份

如果你为“year”参数输入的值介于 0(零)和 1899(包含 1899)之间,则该值将与 1900 相加以计算年份。 下面的公式将返回 1908 年 1 月 2 日:(1900+08)。

= DATE(08,1,2)  

1899 年之后的年份

如果“年份”介于 1900 和 9999(含)之间,则该值充当年份。 以下公式返回 2008 年 1 月 2 日:

= DATE(2008,1,2)  

数月

如果“月份”大于 12,“month”将代表该月份的数字与指定年份中的第一个月相加。 以下公式返回日期 2009 年 2 月 2 日:

= DATE(2008,14,2)  

如果“日期”大于指定月份中的天数,“day”将该天数与月份中的第一天相加。 以下公式返回日期 2008 年 2 月 4 日:

= DATE(2008,1,35)  

日期和时间函数
DAY 函数
TODAY 函数