🕰️SQL Server 2022 introduces the TIME_ZONE_INFO function, enhancing your ability to manage and work with time zone data effectively. This function simplifies handling global applications where time zone differences are crucial for accurate data analysis and reporting.

In this blog, we will explore the TIME_ZONE_INFO function, provide a detailed business use case, and demonstrate its usage with T-SQL queries using the JBDB database.🕰️

Business Use Case: Global E-commerce Platform 🌐

Consider Global Shop, an international e-commerce company operating across multiple time zones. To provide a consistent user experience and synchronize order processing times, Global Shop needs to handle time zone conversions accurately. The TIME_ZONE_INFO function in SQL Server 2022 will be instrumental in managing these time zone differences.

Setting Up the JBDB Database

First, let’s set up the JBDB database and create a sample table Orders to illustrate the use of the TIME_ZONE_INFO function.

-- Create JBDB database
CREATE DATABASE JBDB;
GO

-- Use the JBDB database
USE JBDB;
GO

-- Create Orders table
CREATE TABLE Orders (
    OrderID INT PRIMARY KEY,
    CustomerID INT,
    OrderDateTime DATETIMEOFFSET,
    TimeZone VARCHAR(50),
    Amount DECIMAL(10, 2)
);
GO

-- Insert sample data into Orders
INSERT INTO Orders (OrderID, CustomerID, OrderDateTime, TimeZone, Amount)
VALUES
    (1, 101, '2024-07-01 14:00:00 -07:00', 'Pacific Standard Time', 100.00),
    (2, 102, '2024-07-01 17:00:00 -04:00', 'Eastern Standard Time', 200.00),
    (3, 103, '2024-07-01 19:00:00 +01:00', 'GMT Standard Time', 150.00),
    (4, 104, '2024-07-01 22:00:00 +09:00', 'Tokyo Standard Time', 250.00);
GO

Understanding TIME_ZONE_INFO Function 🧩

The TIME_ZONE_INFO function provides information about time zones, such as their offsets from Coordinated Universal Time (UTC) and daylight saving time rules. This function helps in converting between different time zones and understanding how time zone changes affect your data.

Syntax

TIME_ZONE_INFO(time_zone_name)

• time_zone_name: The name of the time zone for which information is required, such as 'Pacific Standard Time'.

Example Queries

1. Get Time Zone Offset for a Specific Time ZoneRetrieve the current offset from UTC for a specific time zone using sys.time_zone_info:

SELECT tz.name AS TimeZoneName 
       ,tz.current_utc_offset AS UTCOffset
FROM sys.time_zone_info tz
WHERE tz.name = 'Pacific Standard Time';

Convert Order DateTime to UTC

Convert the OrderDateTime from different time zones to UTC for consistent reporting:

SELECT OrderID, CustomerID, OrderDateTime AT TIME ZONE 'Pacific Standard Time' AS LocalTime,
       OrderDateTime AT TIME ZONE 'UTC' AS UTCTime, Amount
FROM Orders;

Find Orders Placed in a Specific Time Range (in Local Time)

Find orders placed between specific times in the ‘Pacific Standard Time’ time zone:

SELECT OrderID, CustomerID, OrderDateTime, TimeZone, Amount
FROM Orders
WHERE OrderDateTime AT TIME ZONE 'Pacific Standard Time' BETWEEN '2024-07-01 00:00:00' AND '2024-07-01 23:59:59';

Find Orders Based on UTC Time Range

Find orders placed within a UTC time range:

SELECT OrderID, CustomerID, OrderDateTime, TimeZone, Amount
FROM Orders
WHERE OrderDateTime AT TIME ZONE 'UTC' BETWEEN '2024-07-01 00:00:00' AND '2024-07-01 23:59:59';

Analyze Orders with Different Time Zones

Group orders by their time zones and calculate the total amount for each time zone:

SELECT TimeZone, COUNT(*) AS NumberOfOrders, SUM(Amount) AS TotalAmount
FROM Orders
GROUP BY TimeZone;

Find Orders with NULL Values in Time Zone Column

Identify orders where the time zone information is missing:

SELECT OrderID, CustomerID, OrderDateTime, TimeZone, Amount
FROM Orders
WHERE TimeZone IS NULL;

Find Orders Where Local Time is in a Specific Range

Find orders where the local time in the ‘Eastern Standard Time’ zone is within a specific range:

SELECT OrderID, CustomerID, OrderDateTime AT TIME ZONE 'Eastern Standard Time' AS LocalTime, Amount
FROM Orders
WHERE OrderDateTime AT TIME ZONE 'Eastern Standard Time' BETWEEN '2024-07-01 10:00:00' AND '2024-07-01 15:00:00';

List Orders by Time Zone and Date

List orders sorted by time zone and the date they were placed:

SELECT OrderID, CustomerID, OrderDateTime, TimeZone, Amount
FROM Orders
ORDER BY TimeZone, OrderDateTime;

Convert and Compare Orders Between Two Time Zones

Compare orders placed in two different time zones:

SELECT OrderID, CustomerID, 
       OrderDateTime AT TIME ZONE 'Pacific Standard Time' AS PSTTime,
       OrderDateTime AT TIME ZONE 'Eastern Standard Time' AS ESTTime,
       Amount
FROM Orders;

Find Orders Where Time Zone is Not Standard

Identify orders where the time zone is not a standard time zone from the list:

SELECT OrderID, CustomerID, OrderDateTime, TimeZone, Amount
FROM Orders
WHERE TimeZone NOT IN (SELECT name FROM sys.time_zone_info);

Detailed Business Use Case 🌍

Scenario: Global Shop needs to analyze sales performance by region while considering time zone differences. The company aims to:

1. Aggregate Sales Data: Calculate total sales and the number of orders for each time zone.
2. Convert Local Time to UTC: Ensure all reports reflect a consistent time standard (UTC).
3. Track Orders: Identify orders placed within specific time ranges in different time zones.

Workflow:

1. Aggregation: Use the TIME_ZONE_INFO function to group orders and analyze sales data by time zone, aiding in regional performance assessments.
2. Time Conversion: Convert local order times to UTC using the AT TIME ZONE function to ensure consistent reporting across different time zones.
3. Reporting: Generate reports based on both local and UTC times, providing a clear and accurate picture of order activity across time zones.

Conclusion 🏁

The TIME_ZONE_INFO function in SQL Server 2022 is a valuable tool for managing and analyzing time zone data. It simplifies time zone conversions and enhances the accuracy of time-based queries, crucial for handling global applications like Global Shop.

By utilizing this function, you can ensure consistent and accurate time data management, improving the reliability of your reports and analyses. 🌟

Feel free to use the provided queries and examples as a starting point for your time zone-related tasks in SQL Server 2022. If you have any questions or need further assistance, drop a comment below! 👇

For more tutorials and tips on SQL Server, including performance tuning and database management, be sure to check out our JBSWiki YouTube channel.

Thank You,
Vivek Janakiraman

Disclaimer:
The views expressed on this blog are mine alone and do not reflect the views of my company or anyone else. All postings on this blog are provided “AS IS” with no warranties, and confers no rights.