DATEFROMPARTS (Transact-SQL)

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2012)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Returns a date value for the specified year, month, and day.

Topic link icon Transact-SQL Syntax Conventions

Syntax

DATEFROMPARTS ( year, month, day )  

Arguments

year
Integer expression specifying a year.

month
Integer expression specifying a month, from 1 to 12.

day
Integer expression specifying a day.

Return types

date

Remarks

DATEFROMPARTS returns a date value with the date portion set to the specified year, month and day, and the time portion set to the default. If the arguments are not valid, then an error is raised. If required arguments are null, then null is returned.

This function is capable of being remoted to SQL Server 2012 servers and above. It will not be remoted to servers with a version below SQL Server 2012.

Examples

The following example demonstrates the DATEFROMPARTS function.

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

Here is the result set.

Result  
----------------------------------  
2010-12-31  

(1 row(s) affected)  

See also

date (Transact-SQL)