Update ICU to 54.1 step 1

source/i18n/unicode/ucal.h

 /*
  *******************************************************************************
- * Copyright (C) 1996-2013, International Business Machines Corporation and
+ * Copyright (C) 1996-2014, International Business Machines Corporation and
  * others. All Rights Reserved.
  *******************************************************************************
  */
 
 #ifndef UCAL_H
 #define UCAL_H
 
 #include "unicode/utypes.h"
 #include "unicode/uenum.h"
 #include "unicode/uloc.h"
@@ skipping 724 matching lines @@
  * @param len The length of zoneID, or -1 if null-terminated.
  * @param status A pointer to an UErrorCode to receive any errors.
  * @stable ICU 2.0
  */
 U_STABLE void U_EXPORT2 
 ucal_setTimeZone(UCalendar*    cal,
                  const UChar*  zoneID,
                  int32_t       len,
                  UErrorCode*   status);
 
-#ifndef U_HIDE_DRAFT_API
 /** 
  * Get the ID of the UCalendar's time zone. 
  * 
  * @param cal           The UCalendar to query. 
  * @param result        Receives the UCalendar's time zone ID. 
  * @param resultLength  The maximum size of result. 
  * @param status        Receives the status. 
  * @return              The total buffer size needed; if greater than resultLength, the output was truncated. 
- * @draft ICU 51 
+ * @stable ICU 51 
  */ 
-U_DRAFT int32_t U_EXPORT2 
+U_STABLE int32_t U_EXPORT2 
 ucal_getTimeZoneID(const UCalendar *cal,
                    UChar *result,
                    int32_t resultLength,
                    UErrorCode *status);
-#endif /* U_HIDE_DRAFT_API */
 
 /**
  * Possible formats for a UCalendar's display name 
  * @stable ICU 2.0
  */
 enum UCalendarDisplayNameType {
   /** Standard display name */
   UCAL_STANDARD,
   /** Short standard display name */
   UCAL_SHORT_STANDARD,
@@ skipping 507 matching lines @@
 /**
  * Returns the canonical system timezone ID or the normalized
  * custom time zone ID for the given time zone ID.
  * @param id        The input timezone ID to be canonicalized.
  * @param len       The length of id, or -1 if null-terminated.
  * @param result    The buffer receives the canonical system timezone ID
  *                  or the custom timezone ID in normalized format.
  * @param resultCapacity    The capacity of the result buffer.
  * @param isSystemID        Receives if the given ID is a known system
      *                      timezone ID.
- * @param status    Recevies the status.  When the given timezone ID
+ * @param status    Receives the status.  When the given timezone ID
  *                  is neither a known system time zone ID nor a
  *                  valid custom timezone ID, U_ILLEGAL_ARGUMENT_ERROR
  *                  is set.
  * @return          The result string length, not including the terminating
  *                  null.
  * @stable ICU 4.0
  */
 U_STABLE int32_t U_EXPORT2
 ucal_getCanonicalTimeZoneID(const UChar* id, int32_t len,
                             UChar* result, int32_t resultCapacity, UBool *isSystemID, UErrorCode* status);
@@ skipping 183 matching lines @@
 * FALSE.
 * @param cal The UCalendar to query.
 * @param type The type of transition desired.
 * @param transition A pointer to a UDate to be set to the transition time.
 *         If the function returns FALSE, the value set is unspecified.
 * @param status A pointer to a UErrorCode to receive any errors.
 * @return TRUE if a valid transition time is set in *transition, FALSE
 *         otherwise.
 * @stable ICU 50
 */
-U_DRAFT UBool U_EXPORT2 
+U_STABLE UBool U_EXPORT2 
 ucal_getTimeZoneTransitionDate(const UCalendar* cal, UTimeZoneTransitionType type,
                                UDate* transition, UErrorCode* status);
 
-#ifndef U_HIDE_DRAFT_API
 /**
 * Converts a system time zone ID to an equivalent Windows time zone ID. For example,
 * Windows time zone ID "Pacific Standard Time" is returned for input "America/Los_Angeles".
 *
 * <p>There are system time zones that cannot be mapped to Windows zones. When the input
 * system time zone ID is unknown or unmappable to a Windows time zone, then this
 * function returns 0 as the result length, but the operation itself remains successful
 * (no error status set on return).
 *
 * <p>This implementation utilizes <a href="http://unicode.org/cldr/charts/supplemental/zone_tzid.html">
 * Zone-Tzid mapping data</a>. The mapping data is updated time to time. To get the latest changes,
 * please read the ICU user guide section <a href="http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data">
 * Updating the Time Zone Data</a>.
 *
 * @param id            A system time zone ID.
 * @param len           The length of <code>id</code>, or -1 if null-terminated.
 * @param winid         A buffer to receive a Windows time zone ID.
 * @param winidCapacity The capacity of the result buffer <code>winid</code>.
 * @param status        Receives the status.
 * @return              The result string length, not including the terminating null.
 * @see ucal_getTimeZoneIDForWindowsID
 *
-* @draft ICU 52
+* @stable ICU 52
 */
-U_DRAFT int32_t U_EXPORT2
+U_STABLE int32_t U_EXPORT2
 ucal_getWindowsTimeZoneID(const UChar* id, int32_t len,
                             UChar* winid, int32_t winidCapacity, UErrorCode* status);
 
 /**
 * Converts a Windows time zone ID to an equivalent system time zone ID
 * for a region. For example, system time zone ID "America/Los_Angeles" is returned
 * for input Windows ID "Pacific Standard Time" and region "US" (or <code>null</code>),
 * "America/Vancouver" is returned for the same Windows ID "Pacific Standard Time" and
 * region "CA".
 *
 * <p>Not all Windows time zones can be mapped to system time zones. When the input
 * Windows time zone ID is unknown or unmappable to a system time zone, then this
 * function returns 0 as the result length, but the operation itself remains successful
 * (no error status set on return).
 *
 * <p>This implementation utilizes <a href="http://unicode.org/cldr/charts/supplemental/zone_tzid.html">
 * Zone-Tzid mapping data</a>. The mapping data is updated time to time. To get the latest changes,
 * please read the ICU user guide section <a href="http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data">
 * Updating the Time Zone Data</a>.
 *
 * @param winid         A Windows time zone ID.
 * @param len           The length of <code>winid</code>, or -1 if null-terminated.
 * @param region        A null-terminated region code, or <code>NULL</code> if no regional preference.
 * @param id            A buffer to receive a system time zone ID.
 * @param idCapacity    The capacity of the result buffer <code>id</code>.
 * @param status        Receives the status.
 * @return              The result string length, not including the terminating null.
 * @see ucal_getWindowsTimeZoneID
 *
-* @draft ICU 52
+* @stable ICU 52
 */
-U_DRAFT int32_t U_EXPORT2
+U_STABLE int32_t U_EXPORT2
 ucal_getTimeZoneIDForWindowsID(const UChar* winid, int32_t len, const char* region,
                                 UChar* id, int32_t idCapacity, UErrorCode* status);
 
-#endif  /* U_HIDE_DRAFT_API */
-
 #endif /* #if !UCONFIG_NO_FORMATTING */
 
 #endif