How to: Enumerate Time Zones Present on a Computer

Successfully working with a designated time zone requires that information about that time zone be available to the system. The Windows XP and Windows Vista operating systems store this information in the registry. However, although the total number of time zones that exist throughout the world is large, the registry contains information about only a subset of them. In addition, the registry itself is a dynamic structure whose contents are subject to both deliberate and accidental change. As a result, an application cannot always assume that a particular time zone is defined and available on a system. The first step for many applications that use time zone information applications is to determine whether required time zones are available on the local system, or to give the user a list of time zones from which to select. This requires that an application enumerate the time zones defined on a local system.

To enumerate the time zones present on the local system

1. Call the TimeZoneInfo.GetSystemTimeZones method. The method returns a generic ReadOnlyCollection<T> collection of TimeZoneInfo objects. The entries in the collection are sorted by their DisplayName property. For example:

   Dim tzCollection As ReadOnlyCollection(Of TimeZoneInfo) = TimeZoneInfo.GetSystemTimeZones
   

   ReadOnlyCollection<TimeZoneInfo> tzCollection;
   tzCollection = TimeZoneInfo.GetSystemTimeZones();
   

2. Enumerate the individual TimeZoneInfo objects in the collection by using a foreach loop (in C#) or a For Each…Next loop (in Visual Basic), and perform any necessary processing on each object. For example, the following code enumerates the ReadOnlyCollection<T> collection of TimeZoneInfo objects returned in step 1 and lists the display name of each time zone on the console.

   For Each timeZone As TimeZoneInfo In tzCollection
      Console.WriteLine("   {0}: {1}", timeZone.Id, timeZone.DisplayName)
   Next
   

   foreach (TimeZoneInfo timeZone in tzCollection)
      Console.WriteLine("   {0}: {1}", timeZone.Id, timeZone.DisplayName);
   

To present the user with a list of time zones present on the local system

1. Call the TimeZoneInfo.GetSystemTimeZones method. The method returns a generic ReadOnlyCollection<T> collection of TimeZoneInfo objects.

2. Assign the collection returned in step 1 to the DataSource property of a Windows forms or ASP.NET list control.

3. Retrieve the TimeZoneInfo object that the user has selected.

The example provides an illustration for a Windows application.

Example

The example starts a Windows application that displays the time zones defined on a system in a list box. The example then displays a dialog box that contains the value of the DisplayName property of the time zone object selected by the user.

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
   Dim tzCollection As ReadOnlyCollection(Of TimeZoneInfo)
   tzCollection = TimeZoneInfo.GetSystemTimeZones()
   Me.timeZoneList.DataSource = tzCollection
End Sub

Private Sub OkButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles OkButton.Click
   Dim selectedTimeZone As TimeZoneInfo = DirectCast(Me.timeZoneList.SelectedItem(), TimeZoneInfo)
   MsgBox("You selected the " & selectedTimeZone.ToString() & " time zone.")
End Sub

private void Form1_Load(object sender, EventArgs e)
{
   ReadOnlyCollection<TimeZoneInfo> tzCollection; 
   tzCollection = TimeZoneInfo.GetSystemTimeZones();
   this.timeZoneList.DataSource = tzCollection;
}

private void OkButton_Click(object sender, EventArgs e)
{
   TimeZoneInfo selectedTimeZone = (TimeZoneInfo) this.timeZoneList.SelectedItem;
   MessageBox.Show("You selected the " + selectedTimeZone.ToString() + " time zone.");
}

Most list controls (such as the System.Windows.Forms.ListBox or System.Web.UI.WebControls.BulletedList control) allow you to assign a collection of object variables to their DataSource property as long as that collection implements the IEnumerable interface. (The generic ReadOnlyCollection<T> class does this.) To display an individual object in the collection, the control calls that object's ToString method to extract the string that is used to represent the object. In the case of TimeZoneInfo objects, the ToString method returns the TimeZoneInfo object's display name (the value of its DisplayName property).

Compiling the Code

This example requires:

• That a reference to System.Core.dll be added to the project.

• That the following namespaces be imported:

  System (in C# code)

  System.Collections.ObjectModel

See Also

Tasks

How to: Save Time Zones to an Embedded Resource

How to: Restore Time Zones from an Embedded Resource

Other Resources

Dates, Times, and Time Zones