DATEFROMPARTS (Transact-SQL)

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

此函数返回映射到指定年、月、日值的 date 值

Transact-SQL 语法约定

语法

DATEFROMPARTS ( year, month, day )  

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法,请参阅早期版本文档

自变量

year
指定年份的整数表达式。

month
指定月份(从1 到12)的整数表达式。

day
指定日期的整数表达式。

返回类型

date

备注

DATEFROMPARTS 返回一个 date 值,其中日期部分设置为指定的年、月和日,时间部分设置为默认值。 对于无效参数,DATEFROMPARTS 将引发错误。 如果至少有一个必需参数具有 NULL 值,则 DATEFROMPARTS 返回 NULL。

此函数可在 SQL Server 2012 (11.x) 及更高版本的服务器上执行远程处理。 它不能无法在版本低于 SQL Server 2012 (11.x) 的服务器上执行远程处理。

示例

此示例演示了操作中的 DATEFROMPARTS 函数。

SELECT DATEFROMPARTS ( 2010, 12, 31 ) AS Result;  

下面是结果集。

Result  
----------------------------------  
2010-12-31  
  
(1 row(s) affected)  

另请参阅

date (Transact-SQL)