DATE 函数
以 datetime 格式返回指定的日期。
语法
DATE(<year>, <month>, <day>)
参数
项 |
定义 |
|---|---|
year |
表示年份的数字。 年参数的值可以包含一到四位。 将根据您的计算机使用的日期系统对年参数进行解释。 支持从 1990 年 3 月 1 日开始的日期。 如果输入了小数，将对该小数取整。 对于大于 9999 或小于零（负值）的值，该函数将返回 #VALUE! 错误。 如果 year 值介于 0 和 1899 之间，则将该值加上 1900 以便生成最终值。 请参阅下面的示例。 备注 应该尽可能使用四位数字作为年份参数，以避免意外结果。例如，使用 07 会将 1907 作为年份值返回。 |
month |
表示月份的数字，或者根据以下规则通过计算得到： 如果 month 是一个从 1 到 12 的数字，那么该数字就表示一年中的某个月。 1 表示一月，2 表示二月，以此类推，到最后的 12 表示十二月。 如果输入一个大于 12 的整数，则会进行以下计算：将 month 值加到 year 上，从而计算出日期。 例如，如果使用 DATE( 2008, 18, 1)，该函数将返回一个相当于 2009 年 6 月 1 日的日期时间值，因为将 18 个月加到 2008 年年初后将生成值 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 值，因为将 32 天加到 3 月初后将生成值 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)