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 |
+--------+-------------------------+
sql-date-functions.htm
广告