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

-- Syntax for SQL Server, Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse  

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)  

Examples: Azure SQL Data Warehouse and Parallel Data Warehouse

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)