SQL - SMALLDATETIMEFROMPARTS() 函式

---

---

SQL 的 SMALLDATETIMEFROMPARTS() 函式用於根據作為此函式引數提供的各個片段構造新的日期時間值。

此函式接受五個引數 - 年、月、日、時和分，並返回一個 datetime 值；如果缺少任何引數，則返回錯誤。

• 如果缺少任何引數，則返回錯誤。

• 如果作為引數傳遞的值無效，則此函式將導致錯誤。

• 如果任何引數為 null，則返回結果為 null。

語法

以下是 SQL SMALLDATETIMEFROMPARTS() 函式的語法 -

SMALLDATETIMEFROMPARTS(year, month, day, hour, minute)

引數

此函式接受五個引數。下面描述了相同的內容 -

• year - 指定 datetime2 值的年份段，表示為整數。

• month - 指定 datetime2 值的月份段，表示為 1 到 12 的整數。

• day - 指定 datetime2 值的日期段，表示為 1 到 31 的整數。

• hour - 指定 datetime2 值的小時段，表示為 0 到 23 的整數。

• minute - 指定 datetime2 值的分鐘段，表示為 0 到 59 的整數。

示例

以下示例演示了 SQL SMALLDATETIMEFROMPARTS() 函式的使用 -

SQL> SELECT SMALLDATETIMEFROMPARTS(2023, 02, 18, 16, 30) AS RESULT;	

輸出

執行上述查詢後，輸出將顯示如下 -

+---------------------+
| RESULT              |
+---------------------+
| 2023-02-18 16:30:00 |
+---------------------+

示例

如果我們為函式的任何引數提供無效值，則會導致錯誤。

SQL> SELECT SMALLDATETIMEFROMPARTS(2023, 02, 34, 87, 72) AS RESULT;

錯誤

如果我們執行程式，則結果將如下所示 -

Cannot construct data type datetime, some of the arguments have values which are not valid.

示例

如果我們為函式的任何引數提供 null，則函式的結果為 null。

SQL> SELECT SMALLDATETIMEFROMPARTS (2023, 02, null, 23, null) AS RESULT;   

輸出

執行上述查詢後，將獲得以下輸出 -

+-----------+
| DATE_TIME |
+-----------+
| NULL      |
+-----------+

示例

我們需要提供函式的所有五個引數。如果我們不提供它，則函式將導致錯誤。

SQL> SELECT SMALLDATETIMEFROMPARTS(2023, 02, 18) AS DATE_TIME;  

錯誤

如果我們執行上述查詢，則結果將如下所示 -

The smalldatetimefromparts function requires 5 argument(s)..

示例

在這裡，我們使用以下查詢將閏年的日期作為引數提供給函式 -

SQL> SELECT SMALLDATETIMEFROMPARTS (2024, 02, 29, 19, 11) AS RESULT

輸出

執行上述查詢後，將獲得以下輸出 -

+---------------------+
| RESULT              |
+---------------------+
| 2024-02-29 19:11:00 |
+---------------------+

示例

在以下示例中，我們將 29 作為日期提供，並且 2023 年不是閏年。因此，函式將返回錯誤。

SQL> SELECT SMALLDATETIMEFROMPARTS (2023, 02, 29, 19, 11) AS RESULT

錯誤

如果我們執行程式，則結果將如下所示 -

Cannot construct data type datetime, some of the arguments have values which are not valid.

示例

假設我們使用如下所示的 CREATE 語句在 SQL 資料庫中建立了一個名為 STUDENTS 的表 -

SQL> CREATE TABLE STUDENTS(ID INT NOT NULL, NAME VARCHAR (200) NOT NULL, YEAR VARCHAR (200) NOT NULL, MONTH VARCHAR (200) NOT NULL, DAY VARCHAR (200) NOT NULL, HOURS VARCHAR (200) NOT NULL, MINUTES VARCHAR (200) NOT NULL)

現在，讓我們使用如下所示的 INSERT 語句在 STUDENTS 表中插入一些記錄 -

SQL> INSERT INTO STUDENTS(ID, NAME, YEAR, MONTH, DAY, HOURS, MINUTES) VALUES(1, 'Dhruv', '2023', '01', '01', '14', '23');
INSERT INTO STUDENTS(ID, NAME, YEAR, MONTH, DAY, HOURS, MINUTES) VALUES(2, 'Arjun', '2023', '02', '01', '05', '43');
INSERT INTO STUDENTS(ID, NAME, YEAR, MONTH, DAY, HOURS, MINUTES) VALUES(3, 'Dev', '2023', '03', '01', '06', '11');
INSERT INTO STUDENTS(ID, NAME, YEAR, MONTH, DAY, HOURS, MINUTES) VALUES(4, 'Riya', '2023', '04', '01', '07', '21');
INSERT INTO STUDENTS(ID, NAME, YEAR, MONTH, DAY, HOURS, MINUTES) VALUES(5, 'Aarohi', '2023', '08', '01', '08', '54');
INSERT INTO STUDENTS(ID, NAME, YEAR, MONTH, DAY, HOURS, MINUTES) VALUES(6, 'Lisa', '2023', '09', '01', '09', '32');
INSERT INTO STUDENTS(ID, NAME, YEAR, MONTH, DAY, HOURS, MINUTES) VALUES(7, 'Roy', '2023', '10', '01', '10', '01');

我們可以使用以下查詢驗證表是否已建立 -

SQL> SELECT * FROM STUDENTS

表 STUDENTS 已成功在 SQL 資料庫中建立。

+----+--------+------+-------+-----+-------+---------+
| ID |  NAME  | YEAR | MONTH | DAY | HOURS | MINUTES |
+----+--------+------+-------+-----+-------+---------+
| 1  | Dhruv  | 2023 | 01    | 01  | 14    | 23      |
| 2  | Arjun  | 2023 | 02    | 01  | 05    | 43      |
| 3  | Dev    | 2023 | 03    | 01  | 06    | 11      |
| 4  | Riya   | 2023 | 04    | 01  | 07    | 21      |
| 5  | Aarohi | 2023 | 08    | 01  | 08    | 54      |
| 6  | Lisa   | 2023 | 09    | 01  | 09    | 32      |
| 7  | Roy    | 2023 | 10    | 01  | 10    | 01      |
+----+--------+------+-------+-----+-------+---------+

在這裡，我們嘗試使用以下查詢連線所有學生的日期和時間值 -

SQL> SELECT NAME, SMALLDATETIMEFROMPARTS(YEAR, MONTH, DAY, HOURS, MINUTES) AS SMALLDATETIMEFROMPARTS_VALUE FROM STUDENTS;

輸出

執行上述查詢後，將獲得以下輸出 -

+--------+-------------------------+
| NAME   | DATETIMEFROMPARTS_VALUE |
+--------+-------------------------+
| Dhruv  | 2023-01-01 14:23:00     |
| Arjun  | 2023-02-01 05:43:00     |
| Dev    | 2023-03-01 06:11:00     |
| Riya   | 2023-04-01 07:21:00     |
| Aarohi | 2023-08-01 08:54:00     |
| Lisa   | 2023-09-01 09:32:00     |
| Roy    | 2023-10-01 10:01:00     |
+--------+-------------------------+