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)