comparison modules/javafx.web/src/main/native/Source/ThirdParty/icu/source/i18n/zonemeta.h @ 10550:fee4ef5c87df

8178360: Build and integrate ICU from source Reviewed-by: kcr, arajkumar
author ghb
date Tue, 04 Jul 2017 09:09:49 +0530
parents
children 20a8447c71c6
comparison
equal deleted inserted replaced
-1:000000000000 0:b6cdad903250
1 /*
2 *******************************************************************************
3 * Copyright (C) 2007-2013, International Business Machines Corporation and *
4 * others. All Rights Reserved. *
5 *******************************************************************************
6 */
7 #ifndef ZONEMETA_H
8 #define ZONEMETA_H
9
10 #include "unicode/utypes.h"
11
12 #if !UCONFIG_NO_FORMATTING
13
14 #include "unicode/unistr.h"
15 #include "hash.h"
16
17 U_NAMESPACE_BEGIN
18
19 typedef struct OlsonToMetaMappingEntry {
20 const UChar *mzid; // const because it's a reference to a resource bundle string.
21 UDate from;
22 UDate to;
23 } OlsonToMetaMappingEntry;
24
25 class UVector;
26 class TimeZone;
27
28 class U_I18N_API ZoneMeta {
29 public:
30 /**
31 * Return the canonical id for this tzid defined by CLDR, which might be the id itself.
32 * If the given system tzid is not known, U_ILLEGAL_ARGUMENT_ERROR is set in the status.
33 *
34 * Note: this internal API supports all known system IDs and "Etc/Unknown" (which is
35 * NOT a system ID).
36 */
37 static UnicodeString& U_EXPORT2 getCanonicalCLDRID(const UnicodeString &tzid, UnicodeString &systemID, UErrorCode& status);
38
39 /**
40 * Return the canonical id for this tzid defined by CLDR, which might be the id itself.
41 * This overload method returns a persistent const UChar*, which is guranteed to persist
42 * (a pointer to a resource).
43 */
44 static const UChar* U_EXPORT2 getCanonicalCLDRID(const UnicodeString &tzid, UErrorCode& status);
45
46 /*
47 * Conveninent method returning CLDR canonical ID for the given time zone
48 */
49 static const UChar* U_EXPORT2 getCanonicalCLDRID(const TimeZone& tz);
50
51 /**
52 * Return the canonical country code for this tzid. If we have none, or if the time zone
53 * is not associated with a country, return bogus string.
54 * @param tzid Zone ID
55 * @param country [output] Country code
56 * @param isPrimary [output] TRUE if the zone is the primary zone for the country
57 * @return A reference to the result country
58 */
59 static UnicodeString& U_EXPORT2 getCanonicalCountry(const UnicodeString &tzid, UnicodeString &country, UBool *isPrimary = NULL);
60
61 /**
62 * Returns a CLDR metazone ID for the given Olson tzid and time.
63 */
64 static UnicodeString& U_EXPORT2 getMetazoneID(const UnicodeString &tzid, UDate date, UnicodeString &result);
65 /**
66 * Returns an Olson ID for the ginve metazone and region
67 */
68 static UnicodeString& U_EXPORT2 getZoneIdByMetazone(const UnicodeString &mzid, const UnicodeString &region, UnicodeString &result);
69
70 static const UVector* U_EXPORT2 getMetazoneMappings(const UnicodeString &tzid);
71
72 static const UVector* U_EXPORT2 getAvailableMetazoneIDs();
73
74 /**
75 * Returns the pointer to the persistent time zone ID string, or NULL if the given tzid is not in the
76 * tz database. This method is useful when you maintain persistent zone IDs without duplication.
77 */
78 static const UChar* U_EXPORT2 findTimeZoneID(const UnicodeString& tzid);
79
80 /**
81 * Returns the pointer to the persistent meta zone ID string, or NULL if the given mzid is not available.
82 * This method is useful when you maintain persistent meta zone IDs without duplication.
83 */
84 static const UChar* U_EXPORT2 findMetaZoneID(const UnicodeString& mzid);
85
86 /**
87 * Creates a custom zone for the offset
88 * @param offset GMT offset in milliseconds
89 * @return A custom TimeZone for the offset with normalized time zone id
90 */
91 static TimeZone* createCustomTimeZone(int32_t offset);
92
93 /**
94 * Returns the time zone's short ID (null terminated) for the zone.
95 * For example, "uslax" for zone "America/Los_Angeles".
96 * @param tz the time zone
97 * @return the short ID of the time zone, or null if the short ID is not available.
98 */
99 static const UChar* U_EXPORT2 getShortID(const TimeZone& tz);
100
101 /**
102 * Returns the time zone's short ID (null terminated) for the zone ID.
103 * For example, "uslax" for zone ID "America/Los_Angeles".
104 * @param tz the time zone ID
105 * @return the short ID of the time zone ID, or null if the short ID is not available.
106 */
107 static const UChar* U_EXPORT2 getShortID(const UnicodeString& id);
108
109 private:
110 ZoneMeta(); // Prevent construction.
111 static UVector* createMetazoneMappings(const UnicodeString &tzid);
112 static void initAvailableMetaZoneIDs();
113 static UnicodeString& formatCustomID(uint8_t hour, uint8_t min, uint8_t sec, UBool negative, UnicodeString& id);
114 static const UChar* getShortIDFromCanonical(const UChar* canonicalID);
115 };
116
117 U_NAMESPACE_END
118
119 #endif /* #if !UCONFIG_NO_FORMATTING */
120 #endif // ZONEMETA_H