TimeZoneNames

Install the TimeZoneNames package using the NuGet Package Manager Console:

PM> Install-Package TimeZoneNames

Compatibility: As of version 7.0.0, the library supports:

• .NET 6 or greater
• .NET Core 2.0 or greater
• .NET Framework 4.6.2 and greater

Note: .NET Framework versions less than 4.6.2 are no longer supported. If you are running .NET 6+ on Linux or macOS, the built-in names now stem from ICU and this library may no longer be needed.

All functionality is provided through static methods in the TZNames class. To use it, import the TimeZoneNames namespace.

using TimeZoneNames;

// Access methods via TZNames
var names = TZNames.GetNamesForTimeZone("America/Los_Angeles", "en-US");

Use TZNames.GetDisplayNameForTimeZone to get a single formatted string representing the time zone, including its UTC offset.

string displayName = TZNames.GetDisplayNameForTimeZone("America/Vancouver", "fr");
// => "(UTC-08:00) Pacifique (É.-U. et Canada)"

string displayName = TZNames.GetDisplayNameForTimeZone("India Standard Time", "zh-CN");
// => "(UTC+05:30) 钦奈，加尔各答，孟买，新德里"

Use TZNames.GetTimeZoneIdsForCountry to get an array of IANA time zone identifiers for a specific country without localized names.

Parameters:

• countryCode (string): The ISO country code (e.g., "AU").
• threshold (DateTime/DateTimeOffset, optional): Limits the list to zones that vary only after this specific date.

// Get all IDs
string[] zones = TZNames.GetTimeZoneIdsForCountry("AU");

// Get IDs with a threshold
string[] zones = TZNames.GetTimeZoneIdsForCountry("AU", DateTimeOffset.Now);

Use TZNames.GetCountryNames to get a dictionary of localized country names, suitable for a country-selection dropdown.

Returns: A dictionary where the key is the ISO country code and the value is the localized name.

var countries = TZNames.GetCountryNames("en-GB");
// Key: "AF", Value: "Afghanistan"

Use TZNames.GetLanguageCodes to retrieve a list of all language codes supported by the library. This is useful for testing or validating input locales.

var languages = TZNames.GetLanguageCodes();

Use TZNames.GetDisplayNames to get a dictionary where the key is a time zone identifier and the value is the localized name. This is useful for providing localized names regardless of the operating system's language.

Parameters:

• locale (string): The language/locale (e.g., "fr-CA").
• useIanaIds (bool, optional): If true, returns IANA time zone IDs as keys (though the list remains limited to valid Windows time zones). If a country code is present in the locale (e.g., CA in fr-CA), it is used for the Windows-to-IANA mapping.

var displayNames = TZNames.GetDisplayNames("fr-CA");

The following methods return lists of time zone IDs that represent a fixed offset from UTC (including UTC itself):

• GetFixedTimeZoneIds(): Returns the IDs.
• GetFixedTimeZoneNames(): Returns the localized names.
• GetFixedTimeZoneAbbreviations(): Returns the abbreviations.

Note: Time zones in the form Etc/GMT[+/-]n use an inverted sign from usual conventions.

Warning: Methods for retrieving localized time zone abbreviations are deprecated due to unreliable source data.

Use TZNames.GetNamesForTimeZone to look up the localized names for a specific time zone using either an IANA ID or a Windows time zone ID. It returns an object containing Generic, Standard, and Daylight names.

// Using IANA ID
var names = TZNames.GetNamesForTimeZone("America/Los_Angeles", "en-US");
// names.Generic == "Pacific Time"
// names.Standard == "Pacific Standard Time"
// names.Daylight == "Pacific Daylight Time"

// Using Windows ID
var names = TZNames.GetNamesForTimeZone("Romance Standard Time", "en-GB");
// names.Generic == "Central European Time"
// names.Standard == "Central European Standard Time"
// names.Daylight == "Central European Summer Time"