smalldatetime (Transact-SQL)

發行項
05/04/2023

適用於：SQL Server Azure SQL資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

定義與當日時間結合的日期。這個時間是以 24 小時制為基礎，而秒鐘一律為零 (:00) 而且不含小數秒數。

注意

對新工作使用 time、date、datetime2 和 datetimeoffset 資料類型。這些類型符合 SQL 標準。它們具有方便移植的特性。 time、datetime2 和 datetimeoffset 提供更多秒數有效位數。 datetimeoffset 可為全域部署的應用程式提供時區支援。

smalldatetime 描述

屬性	值
語法	smalldatetime
使用量	DECLARE @MySmalldatetime smalldatetime CREATE TABLE Table1 ( Column1 smalldatetime )
預設的字串常值格式 (用於下層用戶端)	不適用
日期範圍	1900-01-01 到 2079-06-06 1900 年 1 月 1 日到 2079 年 6 月 6 日
時間範圍	00:00:00 到 23:59:59 2007-05-09 23:59:59 會四捨五入為 2007-05-10 00:00:00
元素範圍	YYYY 是代表年份的四位數，範圍介於 1900 至 2079 之間。 MM 是代表指定年份中某個月份的兩位數，範圍介於 01 至 12 之間。 DD 是代表指定月份中某個日期的兩位數，範圍介於 01 至 31 之間 (視月份而定)。 hh 是代表小時的兩位數，範圍介於 00 至 23 之間。 mm 是代表分鐘的兩位數，範圍介於 00 至 59 之間。 ss 是代表秒鐘的兩位數，範圍介於 00 至 59 之間。 29.998 秒或以下值會無條件捨去到最接近的分鐘。 29.999 秒或以上值會無條件進位到最接近的分鐘。
字元長度	19 個位置上限
儲存體大小	4 個位元組 (固定)。
精確度	一分鐘
預設值	1900-01-01 00:00:00
Calendar	西曆 (不含年份的完整範圍)。
使用者自訂的小數秒數有效位數	否
時區位移感知和保留	否
日光節約感知	否

ANSI 和 ISO 8601 標準

smalldatetime 不符合 ANSI 或 ISO 8601 標準。

轉換日期和時間資料

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

將 smalldatetime 轉換成其他日期與時間類型

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

如果轉換成 date，會複製年、月和日。下列程式碼顯示將 smalldatetime 值轉換成 date 值的結果。

DECLARE @smalldatetime smalldatetime = '1955-12-13 12:43:10';  
DECLARE @date date = @smalldatetime  
  
SELECT @smalldatetime AS '@smalldatetime', @date AS 'date';  
  
--Result  
--@smalldatetime          date  
------------------------- ----------  
--1955-12-13 12:43:00     1955-12-13  
--  
--(1 row(s) affected)

當轉換成 time(n) 時，時、分和秒都會複製。小數秒數會設定為 0。下列程式碼顯示將 smalldatetime 值轉換成 time(4) 值的結果。

DECLARE @smalldatetime smalldatetime = '1955-12-13 12:43:10';  
DECLARE @time time(4) = @smalldatetime;  
  
SELECT @smalldatetime AS '@smalldatetime', @time AS 'time';  
  
--Result  
--@smalldatetime          time  
------------------------- -------------  
--1955-12-13 12:43:00     12:43:00.0000  
--  
--(1 row(s) affected)

當轉換成 datetime 時，smalldatetime 值會複製到 datetime 值。小數秒數會設定為 0。下列程式碼顯示將 smalldatetime 值轉換成 datetime 值的結果。

DECLARE @smalldatetime smalldatetime = '1955-12-13 12:43:10';  
DECLARE @datetime datetime = @smalldatetime;  
  
SELECT @smalldatetime AS '@smalldatetime', @datetime AS 'datetime';  
  
--Result  
--@smalldatetime          datetime  
------------------------- -----------------------  
--1955-12-13 12:43:00     1955-12-13 12:43:00.000  
--  
--(1 row(s) affected)

如果轉換成 datetimeoffset(n) ，smalldatetime 值會複製到 datetimeoffset(n) 值。小數秒數會設定為 0，而時區時差會設定為 +00:0。下列程式碼顯示將 smalldatetime 值轉換成 datetimeoffset(4) 值的結果。

DECLARE @smalldatetime smalldatetime = '1955-12-13 12:43:10';  
DECLARE @datetimeoffset datetimeoffset(4) = @smalldatetime;  
  
SELECT @smalldatetime AS '@smalldatetime', @datetimeoffset AS 'datetimeoffset(4)';  
  
--Result  
--@smalldatetime          datetimeoffset(4)  
------------------------- ------------------------------  
--1955-12-13 12:43:00     1955-12-13 12:43:00.0000 +00:0  
--  
--(1 row(s) affected)

當轉換成 datetime2(n) 時，smalldatetime 值會複製到 datetime2(n) 值。小數秒數會設定為 0。下列程式碼顯示將 smalldatetime 值轉換成 datetime2(4) 值的結果。

DECLARE @smalldatetime smalldatetime = '1955-12-13 12:43:10';  
DECLARE @datetime2 datetime2(4) = @smalldatetime;  
  
SELECT @smalldatetime AS '@smalldatetime', @datetime2 AS ' datetime2(4)';  
  
--Result  
--@smalldatetime           datetime2(4)  
------------------------- ------------------------  
--1955-12-13 12:43:00     1955-12-13 12:43:00.0000  
--  
--(1 row(s) affected)

範例

A. 將包含秒數的字串常值轉換成 smalldatetime

下列範例會比較將字串常值中的秒數轉換成 smalldatetime 的結果。

SELECT   
     CAST('2007-05-08 12:35:29'     AS smalldatetime)  
    ,CAST('2007-05-08 12:35:30'     AS smalldatetime)  
    ,CAST('2007-05-08 12:59:59.998' AS smalldatetime);

輸入	輸出
2007-05-08 12:35:29	2007-05-08 12:35:00
2007-05-08 12:35:30	2007-05-08 12:36:00
2007-05-08 12:59:59.998	2007-05-08 13:00:00

B. 比較 date 和 time 資料類型

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

SELECT   
     CAST('2007-05-08 12:35:29. 1234567 +12:15' AS time(7)) AS 'time'   
    ,CAST('2007-05-08 12:35:29. 1234567 +12:15' AS date) AS 'date'   
    ,CAST('2007-05-08 12:35:29.123' AS smalldatetime) AS   
        'smalldatetime'   
    ,CAST('2007-05-08 12:35:29.123' AS datetime) AS 'datetime'   
    ,CAST('2007-05-08 12:35:29. 1234567 +12:15' AS datetime2(7)) AS   
        'datetime2'  
    ,CAST('2007-05-08 12:35:29.1234567 +12:15' AS datetimeoffset(7)) AS   
        'datetimeoffset';

資料類型	輸出
time	12:35:29. 1234567
date	2007-05-08
smalldatetime	2007-05-08 12:35:00
datetime	2007-05-08 12:35:29.123
datetime2	2007-05-08 12:35:29. 1234567
datetimeoffset	2007-05-08 12:35:29.1234567 +12:15

另請參閱

CAST 和 CONVERT (Transact-SQL)