DATEFROMPARTS (Transact-SQL)

  • Article

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

Reference

date (Transact-SQL)