0 File not found. File not found. B lY> j- l__I|+azD 3p F? // © 2016 and later: Unicode, Inc. and others. // License & terms of use: http://www.unicode.org/copyright.html /* ******************************************************************************* * Copyright (C) 2011-2016, International Business Machines Corporation and * others. All Rights Reserved. ******************************************************************************* */ #ifndef __TZNAMES_H #define __TZNAMES_H /** * \file * \brief C++ API: TimeZoneNames */ #include "unicode/utypes.h" #if U_SHOW_CPLUSPLUS_API #if !UCONFIG_NO_FORMATTING #include "unicode/uloc.h" #include "unicode/unistr.h" U_CDECL_BEGIN /** * Constants for time zone display name types. * @stable ICU 50 */ typedef enum UTimeZoneNameType { /** * Unknown display name type. * @stable ICU 50 */ UTZNM_UNKNOWN = 0x00, /** * Long display name, such as "Eastern Time". * @stable ICU 50 */ UTZNM_LONG_GENERIC = 0x01, /** * Long display name for standard time, such as "Eastern Standard Time". * @stable ICU 50 */ UTZNM_LONG_STANDARD = 0x02, /** * Long display name for daylight saving time, such as "Eastern Daylight Time". * @stable ICU 50 */ UTZNM_LONG_DAYLIGHT = 0x04, /** * Short display name, such as "ET". * @stable ICU 50 */ UTZNM_SHORT_GENERIC = 0x08, /** * Short display name for standard time, such as "EST". * @stable ICU 50 */ UTZNM_SHORT_STANDARD = 0x10, /** * Short display name for daylight saving time, such as "EDT". * @stable ICU 50 */ UTZNM_SHORT_DAYLIGHT = 0x20, /** * Exemplar location name, such as "Los Angeles". * @stable ICU 51 */ UTZNM_EXEMPLAR_LOCATION = 0x40 } UTimeZoneNameType; U_CDECL_END U_NAMESPACE_BEGIN class UVector; struct MatchInfo; /** * TimeZoneNames is an abstract class representing the time zone display name data model defined * by UTS#35 Unicode Locale Data Markup Language (LDML). * The model defines meta zone, which is used for storing a set of display names. A meta zone can be shared * by multiple time zones. Also a time zone may have multiple meta zone historic mappings. *

* For example, people in the United States refer the zone used by the east part of North America as "Eastern Time". * The tz database contains multiple time zones "America/New_York", "America/Detroit", "America/Montreal" and some * others that belong to "Eastern Time". However, assigning different display names to these time zones does not make * much sense for most of people. *

* In CLDR (which uses LDML for representing locale data), the display name * "Eastern Time" is stored as long generic display name of a meta zone identified by the ID "America_Eastern". * Then, there is another table maintaining the historic mapping to meta zones for each time zone. The time zones in * the above example ("America/New_York", "America/Detroit"...) are mapped to the meta zone "America_Eastern". *

* Sometimes, a time zone is mapped to a different time zone in the past. For example, "America/Indiana/Knox" * had been moving "Eastern Time" and "Central Time" back and forth. Therefore, it is necessary that time zone * to meta zones mapping data are stored by date range. * *

Note: * The methods in this class assume that time zone IDs are already canonicalized. For example, you may not get proper * result returned by a method with time zone ID "America/Indiana/Indianapolis", because it's not a canonical time zone * ID (the canonical time zone ID for the time zone is "America/Indianapolis". See * {@link TimeZone#getCanonicalID(const UnicodeString& id, UnicodeString& canonicalID, UErrorCode& status)} about ICU * canonical time zone IDs. * *