* If the system routines fail, or if they specify an i18n_timezone_h or i18n_timezone_h offset
* which is not recognized, the i18n_timezone_h indicated by the ID kLastResortID
* is instantiated and made the default.
+ *
+ * This function determines the default timezone by querying the system once and storing the
+ * obtained timezone as default until the application terminates.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*
* @param[out] timezone A default i18n_timezone_h. Clients are responsible for deleting the time zone object returned.
* If the system routines fail, or if they specify an i18n_timezone_h or i18n_timezone_h offset
* which is not recognized, the i18n_timezone_h indicated by the ID kLastResortID
* is instantiated and made the default.
+ *
+ * This function determines the default timezone by querying the system once and storing the
+ * obtained timezone as default until the application terminates.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*
* @param[out] timezone A default i18n_timezone_h. Clients are responsible for deleting the time zone object returned.
* If the system routines fail, or if they specify an i18n_timezone_h or i18n_timezone_h offset
* which is not recognized, the i18n_timezone_h indicated by the ID kLastResortID
* is instantiated and made the default.
+ *
+ * This function determines the default timezone by querying the system once and storing the
+ * obtained timezone as default until the application terminates.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*
* @param[out] timezone A default i18n_timezone_h. Clients are responsible for deleting the time zone object returned.
int i18n_ucalendar_country_timezones_create(const char *country, i18n_uenumeration_h *enumeration);
/**
- * @brief Returns the default time zone.
- * @details The default is determined initially by querying the host operating system.
- * It may be changed with i18n_ucalendar_set_default_timezone()
- * or with the C++ TimeZone API.
+ * @brief Returns the default time zone (i.e., the one returned by the
+ * i18n_timezone_create_default() function).
+ * @details The default time zone is determined initially by querying the host operating
+ * system and storing the obtained time zone as default until the application terminates.
+ * Therefore, if the time zone is changed after the first call, subsequent calls will not
+ * reflect the change, i.e. the returned time zone will be the same as for the first function
+ * call.
+ *
+ * The default time zone may be changed with i18n_ucalendar_set_default_timezone()
+ * or with the i18n Timezone API.
* @remarks The specific error code can be obtained using the get_last_result()
- * method. Error codes are described in #i18n_error_code_e description.
+ * method. Error codes are described in #i18n_error_code_e description.
* @since_tizen 2.3.1
*
* @param[out] result A buffer to receive the result, or @c NULL
- * @param[in] result_capacity The capacity of the @c result buffer
+ * @param[in] result_capacity The capacity of the @c result buffer
*
* @return The @c result string length, not including the terminating @c NULL.
* @exception #I18N_ERROR_NONE Successful