极客教程SQL TODATETIMEOFFSET() 函数
SQL TODATETIMEOFFSET() 函数是一个日期和时间函数，它使用用户指定的datetime2和时区来返回一个datetimeoffset值。
TODATETIMEOFFSET函数有两个输入参数，一个是目标时区偏移量，一个是没有偏移的日期和时间值，它们简单地组合在一起以产生一个DATETIMEOFFSET值。该函数的输出是一个datetimeoffset数据类型的值。
我们可以以分钟或小时的格式提供时区。如果以分钟提供，则使用整数（-4）；如果以小时提供，则使用字符串（’+06.00’）。时区的范围是+14至-14（小时）。
语法
SQL TODATETIMEOFFSET() 函数的语法如下所示：
TODATETIMEOFFSET(expression,time_zone)
参数
该函数只接受两个参数。具体描述如下：
- expression - 要解析为datetime2值的表达式。
-
time_zone - 表示时区偏移的时间偏移或带符号整数范围，范围从+14到-14。
示例
在以下示例中，我们将使用以下查询更改分钟的时区偏移量。
在此示例中，我们将当前时区更改为-150分钟。
SELECT TODATETIMEOFFSET (GETDATE(), -150) AS Result;
输出
执行上述查询时，输出如下：
+--------------------------------+
| Result |
+--------------------------------+
| 2023-02-20 12:52:55.827 -02:30 |
+--------------------------------+
示例
让我们看看另一种情况，我们将使用正分钟来改变时区，使用以下查询语句：
SELECT TODATETIMEOFFSET (GETDATE(), 360) AS Result;
输出
当查询执行时，将生成以下输出：
+--------------------------------+
| Result |
+--------------------------------+
| 2023-02-20 15:22:33.533 +06:00 |
+--------------------------------+
示例
在以下示例中，我们将使用datetime2值明确设置变量，并应用TODATETIMEOFFSET()到该值，并通过使用以下查询比较这两个值 –
DECLARE @DATE datetime2 = '2023-02-20 02:33:18.0000000';
SELECT @DATE AS 'Original Date',
TODATETIMEOFFSET( @DATE, '+06:00' ) AS '+06:00';
输出
执行上述查询后，输出如下：
+-----------------------------+-------------------------------------+
| Original Date | +06:00 |
+-----------------------------+-------------------------------------+
| 2023-02-20 02:33:18.0000000 | 2023-02-20 02:33:18.0000000 +06:00 |
+-----------------------------+-------------------------------------+
示例
让我们来看另一个示例，在这个示例中，我们将使用以下查询将时区偏移设置为整数。
SELECT TODATETIMEOFFSET( '2023-02-20 02:33:18.0000000', -150 ) AS Result;
输出
上述查询的输出如下所示：
+------------------------------------+
| Result |
+------------------------------------+
| 2023-02-20 02:33:18.0000000 -02:30 |
+------------------------------------+
示例
让我们来看一个示例，我们使用 SYSDATETIMEOFFSET() 函数作为日期表达式，它可以通过以下查询生成SQL服务器运行的系统的当前日期/时间。
SELECT SYSDATETIMEOFFSET() AS 'Current Date',
TODATETIMEOFFSET( SYSDATETIMEOFFSET(), '+06:00' ) AS '+06:00';
输出
当查询执行时，它将生成如下所示的输出 −
+------------------------------------+------------------------------------+
| Current Date | +06:00 |
+------------------------------------+------------------------------------+
| 2023-02-20 14:50:06.8050290 +05:30 | 2023-02-20 14:50:06.8050290 +06:00 |
+------------------------------------+------------------------------------+
示例
在以下示例中，我们使用 DATETIMEOFFSET（） 函数，并通过以下查询使用TODATETIMEOFFSET（）函数来检索偏移值 –
DECLARE @DATE DATETIMEOFFSET = '2023-02-20 14:50:06.8050290 +04:30';
SELECT @DATE AS 'Original Date',
TODATETIMEOFFSET( @DATE, '+06:00' ) AS '+06:00';
输出
运行上述查询后，将生成以下输出−
+------------------------------------+------------------------------------+
| Original Date | +06:00 |
+------------------------------------+------------------------------------+
| 2023-02-20 14:50:06.8050290 +04:30 | 2023-02-20 14:50:06.8050290 +06:00 |
+------------------------------------+------------------------------------+
示例
在下面的示例中，我们使用 DATETIMEOFFSET() 函数，并通过使用以下查询来使用TODATETIMEOFFSET()函数检索偏移值 –
DECLARE @DATE DATETIMEOFFSET = '2023-02-20 14:50:06.8050290 +04:30';
SELECT @DATE AS 'Original Date',
TODATETIMEOFFSET( @DATE, '+06:00' ) AS '+06:00';
输出
运行以上查询，将生成如下所示的输出结果−
+------------------------------------+------------------------------------+
| Original Date | +06:00 |
+------------------------------------+------------------------------------+
| 2023-02-20 14:50:06.8050290 +04:30 | 2023-02-20 14:50:06.8050290 +06:00 |
+------------------------------------+------------------------------------+
示例
看下面的示例，我们将使用小时来改变时区，通过运行以下查询：
SELECT TODATETIMEOFFSET (GETDATE(), '+05:30') AS Result;
输出
如果我们执行上述查询，结果将产生如下：
+--------------------------------+
| Result |
+--------------------------------+
| 2023-02-20 15:12:41.213 +05:30 |
+--------------------------------+
示例
下面是另一个场景，我们将使用负数小时来改变时区，使用以下查询：
SELECT TODATETIMEOFFSET (GETDATE(), '-06:00') AS Result;
输出
执行上述查询后，将生成如下所示的输出结果。
+---------------------------------+
| Result |
+---------------------------------+
| 2023-02-20 15:16:30.247 -06:00 |
+---------------------------------+