Click here to Skip to main content
Click here to Skip to main content

Universal Time Converter

, 2 Jan 2006 CPOL
Rate this:
Please Sign up or sign in to vote.
Illustrates converting time from universal time to local time and vice versa in C++
Sample Image - TimeZoneConverter/TimeZoneConverter.jpg

Introduction

Recently we had a requirement which demands knowledge of all the time zones and doing conversions from universal time to local time and vice versa. I searched for the code which would do this, but most of them happened to be in C#, article by Mike Dimmick is quite good but this was also in C# and there was very limited information available for doing this in C++. So I thought of putting together C++ code which does this on CodeProject. The different steps involved in writing this code are explained in the following sections. (I am not an English expert, but I tried my best to make the intention as clear as possible).

Enumerating TimeZones

There are no direct API's in Windows to enumerate time zones. We need to do get all the time zone information from the registry. The following key in the registry contains a list of time zones in alphabetical order in the form of sub keys:

"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones"

Each subkey under the above subkey will give information about individual timezone. This individual subkey will have the following value names.

For eg: subkey ALASKAN STANDARD TIME will have information like this:

Display : (GMT - 9:00) Alaska
Dlt : Alaskan DayLight Time
Index : 0x00000003 (3)
MapID : 30,31
Std : Alaskan Standard Time
TZI : TimeZone Information in Binary Form

Of all these values, TZI happens to be critical information, which needs to be retrieved.
This value has the following data:

long Bias
long StandardBias
long DaylightBias
SYSTEMTIME StandardDate
SYSTEMTIME DaylightDate

We need to retrieve this information, first by enumerating all sub keys under "SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones", then by querying values under each of the sub keys.

CTimeZoneInfoManager::EnumerateTimeZones() will have related code which would read all sub keys information of "SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones".

int CTimeZoneInfoManager::GetFullTimeZoneInfoFromRegistry() will have code which will fill the necessary time zone information structures, which are required for conversion.

Finally all the time zone information is collected in the template based class CArray<CRegTimeZoneInfo*, CRegTimeZoneInfo*> in alphabetical order.

Sorting TimeZones

Now we have time zone information in alphabetical form, but we need to have this information sorted on the offset from GMT time (bias). There are several ways to do this, but I have selected qsort() function. We need to supply the starting address of the array and a callback comparison function which will get called when sorting the CArray.

We need to pass the address of the first element of CArray and a comparison function to qsort(). The comparison function will decide the criteria on which we will sort the code. We need to sort time zones based on the offset from GMT or standard bias.

int CTimeZoneInfoManager::SortTimeZoneList()
TimeZoneComparer(const void *i_TZ1, const void *i_TZ2)

will have the related code.

FINALLY...THE TIME CONVERSION

The following APIs do the necessary conversion from local time in given TimeZone to universal time.

  • TzSpecificLocalTimeToSystemTime()
  • SystemTimeToTzSpecificLocalTime()

The SystemTimeToTzSpecificLocalTime() API takes TIME_ZONE_INFORMATION, Universal time as input and returns localtime which corresponds to supplied TIME_ZONE_INFORMATION. We will fill this TIME_ZONE_INFORMATION structure from the information we retrieved from the registry. One particular thing we need to be careful here is that the information we collected from registry for "StandardName" and "DayLightName" is in ANSI form, but TIME_ZONE_INFORMATION requires these values to be in widechar or Unicode format, so we need to use MultiByteToWideChar() and WideCharToMultiByte() functions to do the necessary conversions wherever necessary.

The TzSpecificLocalTimeToSystemTime() API does exactly the reverse of the above API, that is, it takes TIME_ZONE_INFORMATION and the corresponding local time as input and converts to universal time. But unfortunately, this is available only on XP and later OS versions!(to compile the code under XP, please uncomment "//#define _XP_OR_LATER" in TimeZoneInfoManager.cpp)

For the OS versions below XP, we can convert local time of currenttimezone to universal time using code like this:

int CTimeZoneInfoManager::SpecificLocalTimeToSystemTime
	(SYSTEMTIME* i_stLocal, SYSTEMTIME* o_stUniversal)
{

    FILETIME ft, ft_utc;

    if (!(SystemTimeToFileTime(i_stLocal, &ft) && 
          LocalFileTimeToFileTime(&ft, &ft_utc) &&
          FileTimeToSystemTime(&ft_utc,o_stUniversal)))
         {
            return 0;
         }

        return 1;
}

But SpecificLocalTimeToSystemTime() has other limitations too. It always considers daylight bias to be -60 and there may be a difference in behaviour of TzSpecificLocalTimeToSystemTime() and SpecificLocalTimeToSystemTime() in case of daylight savings.

The following functions have related code:

  • int CTimeZoneInfoManager::ConvertFromLocalToUTC()
  • int CTimeZoneInfoManager::ConvertFromUTClToLocal()

Sample Application

The application has very basic GUI. I have used simple datetimepicker control for I/O purposes of date and time. We can choose the option of converting UTCtoLocal or LocalToUTC from the provided radio buttons. Based on the selection, datepicker used for I/P gets enabled and datepicker used for O/P gets disabled. Whenever there is a change in the I/P, output changes automatically. We can select the required timezone from the combobox.

Conclusion

I hope this would help atleast some programmers who are looking for information related to timezones and timezone conversions.

History

  • 2nd January, 2006: Initial post

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Ramesh Ketha

United States United States
No Biography provided

Comments and Discussions

 
GeneralRegarding Local Time to UTC conversion Pinmemberdhdfghdfhdfhg9-Sep-08 1:49 
AnswerRe: Regarding Local Time to UTC conversion Pinmemberprantlf4-Sep-09 2:14 
QuestionHow to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP Pinmembertrysunil13-Apr-08 16:24 
AnswerRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP Pinmembertrysunil13-Apr-08 18:54 
GeneralRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP PinmemberAnatoly Ivasyuk29-Aug-08 10:56 
GeneralRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP PinmemberHugh Jizak16-Dec-08 10:17 
GeneralRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP Pinmemberehsiung4-Jan-09 13:17 
GeneralRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP Pinmembertrysunil4-Jan-09 13:33 
QuestionRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP PinmemberZhi Chen9-Feb-09 6:06 
AnswerRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP Pinmembertrysunil9-Feb-09 14:13 
Hello Zhi,
 
The implemetation is exactly similar to the microsoft implementation of TzSpecificLocalTimeToSystemTime(). I have verified the code by comparing the outputs with Microsoft functions. The results are accurate.
 
I guess you can use the code as it is.
QuestionRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP PinmemberZhi Chen13-Feb-09 10:24 
AnswerRe: How to make the TzSpecificLocalTimeToSystemTime work for Os &lt; Win XP Pinmemberehsiung12-Jun-09 7:11 
GeneralInvalid Property Value Pinmemberwhoisthis4-Jan-06 7:40 
GeneralRe: Invalid Property Value PinmemberBrian (BH)10-Jan-06 23:15 
GeneralRe: Invalid Property Value Pinmembershadow7919-Jul-06 20:25 
GeneralRe: Invalid Property Value PinmembermacALEX28-Sep-06 19:02 
GeneralRe: Invalid Property Value Pinmemberp4abit24-Apr-07 0:49 
GeneralRe: Invalid Property Value PinmemberArunKumar Yalamarthy22-May-07 20:23 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web03 | 2.8.141029.1 | Last Updated 3 Jan 2006
Article Copyright 2006 by Ramesh Ketha
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid