SQL - DATETIME2FROMPARTS() 函数

上一页
下一页

SQL 的DATETIME2FROMPARTS()函数用于从单个日期和时间段构造一个datetime2值。

此函数接受八个参数，例如年、月、日、时、分、秒和精度，并返回一个表示指定时间的datetime2值。

  • 如果作为参数传递的值无效，则此函数将导致错误。

  • 如果任何参数为 null，则它将返回结果为 null。

  • 如果缺少任何参数，它将返回错误。

此函数主要用于当 datetime2 值的年、月、日、时、分、秒和小数秒有单独的值时，并希望将其组合成单个 datetime2 值。

语法

以下是 SQL DATETIME2FROMPARTS()函数的语法：

DATETIME2FROMPARTS(year, month, day, hour, minute, seconds, fractions, precision)

参数

此函数接受八个参数。下面描述了相同的内容：

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

  • month - 指定 datetime2 值的月份段，以 1 到 12 之间的整数表示。

  • day - 指定 datetime2 值的日期段，以 1 到 31 之间的整数表示。

  • hour - 指定 datetime2 值的小时段，以 0 到 23 之间的整数表示。

  • minute - 指定 datetime2 值的分钟段，以 0 到 59 之间的整数表示。

  • seconds - 指定 datetime2 值的秒段，以 0 到 59 之间的整数表示。

  • fractions - 指定 datetime2 值的小数部分，以 0 到 9999999 之间的整数表示。

  • precision - 指定要返回的 datetime2 值的精度。

示例

在以下示例中，我们尝试使用以下查询构造一个不带秒小数的 datetime2 值：

SQL> SELECT DATETIME2FROMPARTS(2023, 02, 20, 06, 10, 45, 0, 0) AS RESULT;

输出

执行上述查询后，输出将显示如下：

+---------------------+
| RESULT              |
+---------------------+
| 2023-02-20 06:10:45 |
+---------------------+

示例

让我们尝试使用 SQL DATETIME2FROMPARTS()函数的小数和精度参数：

  • 当分数值为 5 且精度值为 1 时，分数值表示 5/10 秒。

  • 当分数值为 5 且精度值为 2 时，分数值表示 5/100 秒。

  • 当分数值为 5 且精度值为 3 时，分数值表示 5/1000 秒。

SQL> SELECT DATETIME2FROMPARTS(2023, 02, 20, 06, 10, 45, 5, 1) AS RESULT_1;  
SQL> SELECT DATETIME2FROMPARTS(2023, 02, 20, 06, 10, 45, 5, 2) AS RESULT_2;  
SQL> SELECT DATETIME2FROMPARTS(2023, 02, 20, 06, 10, 45, 5, 3) AS RESULT_3;

输出

如果我们执行程序，则结果将如下所示：

+-----------------------+
| RESULT                |
+-----------------------+
| 2023-02-20 06:10:45.5 |
+-----------------------+

+------------------------+
| RESULT                 |
+------------------------+
| 2023-02-20 06:10:45.05 |
+------------------------+

+-------------------------+
| RESULT                  |
+-------------------------+
| 2023-02-20 06:10:45.005 |
+-------------------------+

示例

在这里，我们为函数的任何参数提供无效值，这会导致错误。

SQL> SELECT DATETIME2FROMPARTS(2023, 16, 45, 29, 76, 88, 5, 1) AS RESULT;

输出

当我们执行上述查询时，输出将获得如下所示：

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

示例

如果我们将函数的任何参数提供为null，则该函数将返回 null。

SQL> SELECT DATETIME2FROMPARTS(2023, null, null, null, 34, 30, 5, 1) AS RESULT;

输出

当我们执行上述查询时，输出将获得如下所示：

+--------+
| RESULT |
+--------+
| NULL   |
+--------+

示例

我们需要提供函数的所有五个参数。如果我们不提供它，则函数将导致错误。

SQL> SELECT DATETIME2FROMPARTS(2023, 02, 20, 06, 10) AS RESULT;

输出

如果我们执行上述查询，则结果将如下所示：

The datetime2fromparts function requires 8 argument(s).

示例

假设我们在 SQL 数据库中使用 CREATE 语句创建了一个名为 STUDENTS 的表，如下面的查询所示：

SQL> CREATE TABLE STUDENTS(ID INT NOT NULL, NAME VARCHAR (200) NOT NULL, YEARS VARCHAR (200) NOT NULL, MONTHS VARCHAR (200) NOT NULL, DAYS VARCHAR (200) NOT NULL, HOURS VARCHAR (200) NOT NULL, MINUTES VARCHAR (200) NOT NULL, SECONDS VARCHAR (200) NOT NULL);

现在，让我们使用 INSERT 语句在 STUDENTS 表中插入一些记录，如下面的查询所示：

SQL> INSERT INTO STUDENTS(ID, NAME, YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS) VALUES(1, 'Dhruv', '2000', '02', '01', '14', '30', '00');
INSERT INTO STUDENTS(ID, NAME, YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS) VALUES(2, 'Arjun', '2001', '05', '20', '02', '34', '45');
INSERT INTO STUDENTS(ID, NAME, YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS) VALUES(3, 'Dev', '2000', '05', '25', '05', '56', '45');
INSERT INTO STUDENTS(ID, NAME, YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS) VALUES(4, 'Riya', '2003', '01', '10', '17', '21', '23');
INSERT INTO STUDENTS(ID, NAME, YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS) VALUES(5, 'Aarohi','1999', '12', '20', '23', '36', '54');
INSERT INTO STUDENTS(ID, NAME, YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS) VALUES(6, 'Lisa', '2004', '07', '17', '10', '46', '13');
INSERT INTO STUDENTS(ID, NAME, YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS) VALUES(7, 'Roy', '2003', '09', '19', '04', '30', '00');

我们可以使用以下查询验证表是否已创建：

SQL> SELECT * FROM STUDENTS

表 STUDENTS 已成功在 SQL 数据库中创建。

+----+-------+-------+--------+------+-------+---------+---------+
| ID | NAME  | YEARS | MONTHS | DAYS | HOURS | MINUTES | SECONDS |
+----+-------+-------+--------+------+-------+---------+---------+
| 1  | Dhruv | 2000  | 02     | 01   | 14    | 30      | 00      |
| 2  | Arjun | 2001  | 05     | 20   | 02    | 34      | 45      |
| 3  | Dev   | 2000  | 05     | 25   | 05    | 56      | 45      |
| 4  | Riya  | 2003  | 01     | 10   | 17    | 21      | 23      |
| 5  | Aarohi| 1999  | 12     | 20   | 23    | 36      | 54      |
| 6  | Lisa  | 2004  | 07     | 17   | 10    | 46      | 13      |
| 7  | Roy   | 2003  | 09     | 19   | 04    | 30      | 00      |
+----+-------+-------+--------+------+-------+---------+---------+

在这里，我们连接所有学生的 datetime2 值以使用以下查询检索学生的出生日期和时间：

SQL> SELECT NAME, DATETIME2FROMPARTS(YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS, 0, 2) AS STUDENTS_BIRTH_DATE_AND_TIME FROM STUDENTS;

输出

当我们执行上述查询时，输出将获得如下所示：

+--------+------------------------------+
| NAME   | STUDENTS_BIRTH_DATE_AND_TIME |
+--------+------------------------------+
| Dhruv  | 2000-02-01 14:30:00.00       |
| Arjun  | 2001-05-20 02:34:45.00       |
| Dev    | 2000-05-25 05:56:45.00       |
| Riya   | 2003-01-10 17:21:23.00       |
| Aarohi | 1999-12-20 23:36:54.00       |
| Lisa   | 2004-07-17 10:46:13.00       |
| Roy    | 2003-09-19 04:30:00.00       |
+--------+------------------------------+
sql-date-functions.htm
打印页面
上一页
下一页
广告