DATEFROMPARTS (Transact-SQL)

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

此函式會傳回對應至指定年份、月份和日期值的 date 值。

Transact-SQL 語法慣例

Syntax

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)

另請參閱

日期 (Transact-SQL)