日期 (Transact-SQL)

適用于： Microsoft Fabric 中 Microsoft Fabric 倉儲中的 SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW） SQL 分析端點

定義 SQL Server 中的日期。 SQL Server 2008 （10.0.x） 引進日期 資料類型。

日期描述

date 支援的字串常值格式

下表顯示 date 資料類型的有效字串常值格式。

ANSI 和 ISO 8601 合規性

date 符合西曆的 ANSI SQL 標準定義：

注意 85 - Datetime 資料類型將允許以西曆格式的日期儲存在日期範圍 0001-01-01 CE 到 9999-12-31 CE。

預設字串常值格式，用於下層用戶端，符合定義為 yyyy-MM-dd 的 SQL 標準格式。 此格式與 的 DATE ISO 8601 定義相同。

下層用戶端的回溯相容性

有些下層用戶端不支援 time、date、datetime2 及 datetimeoffset 資料類型。 下表顯示上層 SQL Server 執行個體與下層用戶端之間的類型對應。

轉換日期和時間資料

當您轉換成日期與時間資料類型時，SQL Server 會拒絕所有無法辨識為日期或時間的值。 如需搭配日期和時間資料使用 CAST 和 CONVERT 函式的相關資訊，請參閱 CAST 和 CONVERT （Transact-SQL）。

將日期轉換為其他日期和時間類型

本節描述當 date 資料類型轉換成其他日期和時間資料類型時，可能發生的狀況。

當轉換為 time（ n ） 時，轉換會失敗，並引發錯誤訊息 206：

運算元類型衝突：日期與時間不相容。

如果轉換為 datetime ，則會複製日期元件。 下列程式碼顯示將日期 值 轉換成 datetime 值的結果。

DECLARE @date DATE = '12-10-25';
DECLARE @datetime DATETIME = @date;

SELECT @date AS '@date',
    @datetime AS '@datetime';

以下為結果集。

@date      @datetime
---------- -----------------------
2025-12-10 2025-12-10 00:00:00.000

當轉換為 Smalldatetime 時， 日期 值會位於 Smalldatetime 的範圍內 、複製日期元件，並將時間元件設定為 00:00:00.000 。 當 date 值超出 Smalldatetime 值的範圍 時，就會引發錯誤訊息 242，並將 Smalldatetime 值設定為 NULL ：

將日期資料類型轉換成 Smalldatetime 資料類型會導致超出範圍的值。

下列程式碼顯示將日期 值 轉換成 Smalldatetime 值的結果。

DECLARE @date DATE = '1912-10-25';
DECLARE @smalldatetime SMALLDATETIME = @date;

SELECT @date AS '@date',
    @smalldatetime AS '@smalldatetime';

以下為結果集。

@date      @smalldatetime
---------- -------------------
1912-10-25 1912-10-25 00:00:00

若要轉換成 datetimeoffset（ n ） ，則會複製日期，並將時間設定為 00:00.0000000 +00:00 。 下列程式碼顯示將日期 值 轉換成 datetimeoffset（3） 值的結果。

DECLARE @date DATE = '1912-10-25';
DECLARE @datetimeoffset DATETIMEOFFSET(3) = @date;

SELECT @date AS '@date',
    @datetimeoffset AS '@datetimeoffset';

以下為結果集。

@date      @datetimeoffset
---------- ------------------------------
1912-10-25 1912-10-25 00:00:00.000 +00:00

當轉換為 datetime2（ n ） 時，會複製日期元件，並將時間元件設定為 00:00.000000 。 下列程式碼顯示將日期 值 轉換成 datetime2（3） 值的結果。

DECLARE @date DATE = '1912-10-25'
DECLARE @datetime2 DATETIME2(3) = @date;

SELECT @date AS '@date',
    @datetime2 AS '@datetime2(3)';

以下為結果集。

@date      @datetime2(3)
---------- -----------------------
1912-10-25 1912-10-25 00:00:00.000

將字串常值轉換為日期

如果整個字串皆是有效的格式，即可從字串常值轉換為日期與時間類型。 否則，就會引發執行階段錯誤。 不指定樣式的隱含轉換或明確轉換，從日期和時間類型到字串常值，都是目前會話的預設格式。 下表是字串常值轉換為 date 資料類型的規則。

範例

下列範例會比較將字串轉換成各種 date 和 time 資料類型的結果。

SELECT
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS TIME(7)) AS 'time',
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS DATE) AS 'date',
    CAST('2022-05-08 12:35:29.123' AS SMALLDATETIME) AS 'smalldatetime',
    CAST('2022-05-08 12:35:29.123' AS DATETIME) AS 'datetime',
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS DATETIME2(7)) AS 'datetime2',
    CAST('2022-05-08 12:35:29.1234567 +12:15' AS DATETIMEOFFSET(7)) AS 'datetimeoffset';

以下為結果集。

另請參閱

• CAST 和 CONVERT (Transact-SQL)