SQL - SWITCHOFFSET() Function

---

---

The SQL SWITCHOFFSET() function can be used to return datetimeoffset values that have been changed from the stored time zone offset to a given new time zone offset.

In contrast to DATETIMEOFFSET, SWITCHOFFSET serves a different function. It converts the source value's offset to the target value based on two inputs: a DATETIMEOFFSET value and a target time zone offset. The UTC value is the same for both the input and the output; you just want to switch the input values' offset from the source offset at which they were originally recorded to a desired target offset.

Syntax

Following is the syntax of the SQL SWITCHOFFSET() function −

SWITCHOFFSET( expression, time_zone )

Parameters

This function accepts two parameters as discussed below −

• expression − that to be resolved into datetimeoffset value

• time_zone − it is a timezone offset or signed integer.

Example

In the following example, we are trying to demonstrate the SWITCHOFFSET() function −

SELECT SWITCHOFFSET( '2023-02-20', '+06:00' ) AS Result;

Output

When we execute the above query, the output is obtained as follows −

+------------------------------------+
| Result                             |
+------------------------------------+
| 2023-02-20 06:00:00.0000000 +06:00 |
+------------------------------------+

Example

Here, we are going to use the negative value with the SWITCHOFFSET() function −

SELECT SWITCHOFFSET( '2023-02-20', '-06:00' ) AS Result;

Output

When the query, gets executed it will generate the output as shown below −

+------------------------------------+
| Result                             |
+------------------------------------+
| 2023-02-19 18:00:00.0000000 -06:00 |
+------------------------------------+

Example

In the following example, we are going to set a variable, assign a date to it using DATETIMEOFFSET(), apply SWITCHOFFSET() to that date, and compare it with the original date by using the following query −

DECLARE @DATE datetimeoffset = '2023-02-19 18:00:00.0000000 -06:00';
SELECT @DATE AS 'Original Date',
   SWITCHOFFSET( @DATE, '+05:30' ) AS '+05:30';

Output

On executing the above query, the output is displayed as follows −

+------------------------------------+------------------------------------+
| Original Date                      | +05:30                             |
+------------------------------------+------------------------------------+
| 2023-02-19 18:00:00.0000000 -06:00 | 2023-02-20 05:30:00.0000000 +05:30 |
+------------------------------------+------------------------------------+

Example

Here, we are using the DATETIMEOFFSET() −

DECLARE
   @DATE AS DATETIMEOFFSET = '2023-02-20 04:10:00.0000000 +04:10',
   @TIMEZONE AS CHAR(6)= '-08:00'; 
SELECT SWITCHOFFSET(@DATE, @TIMEZONE) AS Result;

Output

When the query, gets executed it will generate the output as shown below −

+------------------------------------+
| Result                             |
+------------------------------------+
| 2023-02-19 16:00:00.0000000 -08:00 |
+------------------------------------+

Example

In the following query, we are going to use SYSDATETIMEOFFSET() function for generating the current date/time and offset −

SELECT SYSDATETIMEOFFSET() AS 'Current Date',
   SWITCHOFFSET( SYSDATETIMEOFFSET(), '+07:30' ) AS '+07:30';

Output

The output for the above query is produced as given below −

+------------------------------------+------------------------------------+
| Current  Date                      | +07:30                             |
+------------------------------------+------------------------------------+
| 2023-02-20 16:03:59.8684429 +05:30 | 2023-02-20 18:03:59.8684429 +07:30 |
+------------------------------------+------------------------------------+

Example

Consider another example in which we use the SYSDATETIMEOFFSET() function to generate the current date and time of the system on which SQL Server is running. Here we are going to add negative value −

SELECT SYSDATETIMEOFFSET() AS 'Current Date',
   SWITCHOFFSET( SYSDATETIMEOFFSET(), '-05:30' ) AS '-05:30';

Output

When the query gets executed, it will generate an output as shown below −

+------------------------------------+------------------------------------+
| Current  Date                      | -05:30                             |
+------------------------------------+------------------------------------+
| 2023-02-20 16:09:15.0193356 +05:30 | 2023-02-20 05:09:15.0193356 -05:30 |
+------------------------------------+------------------------------------+

Example

In the following example, we are going to use an integer for the time zone offset instead of a string and check the query to do so −

SELECT SWITCHOFFSET( '2023-02-20', 250 ) AS Result;

Output

On running the above query, it will generate an output as shown below −

+------------------------------------+
| Result                             |
+------------------------------------+
| 2023-02-20 04:10:00.0000000 +04:10 |
+------------------------------------+