SQL - DATETIMEFROMPARTS() 函式

---

---

SQL 的DATETIMEFROMPARTS() 函式用於根據作為引數提供給此函式的各個部分構造新的 datetime 值。

此函式接受七個引數：年、月、日、時、分、秒和毫秒，並返回一個datetime 值。

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

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

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

語法

以下是 SQL DATETIMEFROMPARTS() 函式的語法：

DATETIMEFROMPARTS(year, month, day, hour, minute, seconds, milliseconds)

引數

此函式接受七個引數。具體描述如下：

• year - 指定 datetime2 值的年份部分，以整數表示。

• month - 指定 datetime2 值的月份部分，以 1 到 12 之間的整數表示。

• day - 指定 datetime2 值的日期部分，以 1 到 31 之間的整數表示。

• hour - 指定 datetime2 值的小時部分，以 0 到 23 之間的整數表示。

• minute - 指定 datetime2 值的分鐘部分，以 0 到 59 之間的整數表示。

• seconds - 指定 datetime2 值的秒部分，以 0 到 59 之間的整數表示。

• milliseconds - 指定 datetime 值的毫秒部分。

示例

以下示例演示了 SQL DATETIMEFROMPARTS() 函式的使用：

SQL> SELECT DATETIMEFROMPARTS (2023, 02, 17, 17, 01, 45, 000) AS DATE_TIME;

輸出

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

+-------------------------+
| DATE_TIME               |
+-------------------------+
| 2023-02-17 17:01:45.000 |
+-------------------------+

示例

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

SQL> SELECT DATETIMEFROMPARTS (2023, 02, 34, 53, 67, 45, 000) AS DATE_TIME; 

錯誤

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

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

示例

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

SQL> SELECT DATETIMEFROMPARTS (2023, 02, null, 23, null, 45, 000) AS DATE_TIME;  

輸出

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

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

示例

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

SQL> SELECT DATETIMEFROMPARTS (2023, 02, 17) AS DATE_TIME;  

錯誤

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

The datetimefromparts function requires 7 argument(s).

示例

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

SQL> SELECT DATETIMEFROMPARTS (2024, 02, 29, 19, 11, 55, 343) AS DATE_TIME;

輸出

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

+-------------------------+
| DATE_TIME               |
+-------------------------+
| 2024-02-29 19:11:55.343 |
+-------------------------+

示例

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

SQL> SELECT DATETIMEFROMPARTS (2023, 02, 29, 19, 11, 55, 343) AS DATE_TIME

錯誤

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

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, SECONDS VARCHAR (200) NOT NULL, MILLISECONDS VARCHAR (200) NOT NULL)

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

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

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

SQL> SELECT * FROM STUDENTS

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

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

我們可以使用以下查詢連線所有學生的日期和時間值：

SQL> SELECT NAME, DATETIMEFROMPARTS(YEAR, MONTH, DAY, HOURS, MINUTES, SECONDS, MILLISECONDS) AS DATETIMEFROMPARTS_VALUE FROM STUDENTS;

輸出

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

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