class Elm_Datetime (Elm_Layout)
{
   eo_prefix: elm_obj_datetime;
   properties {
      format {
         set {
            /*@
            @brief Set the datetime format. Format is a combination of allowed Libc date format
            specifiers like: "%b %d, %Y %I : %M %p".

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @remark Maximum allowed format length is 64 chars.

            @remark Format can include separators for each individual datetime field except
            for AM/PM field.

            @remark Each separator can be a maximum of 6 UTF-8 bytes.
            Space is also taken as a separator.

            @remark Following are the allowed set of format specifiers for each datetime field.

            @b %%Y : The year as a decimal number including the century.

            @b %%y : The year as a decimal number without a century (range 00 to 99).

            @b %%m : The month as a decimal number (range 01 to 12).

            @b %%b : The abbreviated month name according to the current locale.

            @b %%B : The full month name according to the current locale.

            @b %%h : The abbreviated month name according to the current locale(same as %%b).

            @b %%d : The day of the month as a decimal number (range 01 to 31).

            @b %%e : The day of the month as a decimal number (range 1 to 31). single
            digits are preceded by a blank.

            @b %%I : The hour as a decimal number using a 12-hour clock (range 01 to 12).

            @b %%H : The hour as a decimal number using a 24-hour clock (range 00 to 23).

            @b %%k : The hour (24-hour clock) as a decimal number (range 0 to 23). single
            digits are preceded by a blank.

            @b %%l : The hour (12-hour clock) as a decimal number (range 1 to 12); single
            digits are preceded by a blank.

            @b %%M : The minute as a decimal number (range 00 to 59).

            @b %%p : Either 'AM' or 'PM' according to the given time value, or the
            corresponding strings for the current locale. Noon is treated as 'PM'
            and midnight as 'AM'.

            @b %%P : Like %p but in lower case: 'am' or 'pm' or a corresponding string for
            the current locale.

            @b %%c : The preferred date and time representation for the current locale.

            @b %%x : The preferred date representation for the current locale without the time.

            @b %%X : The preferred time representation for the current locale without the date.

            @b %%r : The complete calendar time using the AM/PM format of the current locale.

            @b %%R : The hour and minute in decimal numbers using the format %H:%M.

            @b %%T : The time of day in decimal numbers using the format %H:%M:%S.

            @b %%D : The date using the format %%m/%%d/%%y.

            @b %%F : The date using the format %%Y-%%m-%%d.

            @remark These specifiers can be arranged in any order and the widget will display the
            fields accordingly.

            @remark Default format is taken as per the system locale settings.

            @see elm_datetime_format_get()
            @ingroup Datetime */
         }
         get {
            /*@ @brief Get the datetime format.

            @if MOBILE @since_tizen 2.3
            @elseif WEARABLE @since_tizen 2.3.1
            @endif

            @ingroup Datetime

            */
         }
         values {
            const(char)* fmt; /*@ The datetime format */
         }
      }
   }
   methods {
      field_limit_set {
         /*@
         @brief Set the field limits of a field.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Limits can be set to individual fields, independently, except for AM/PM field.
         Any field can display the values only in between these Minimum and Maximum limits unless
         the corresponding time value is restricted from MinTime to MaxTime.
         That is, Min/ Max field limits always works under the limitations of MinTime/ MaxTime.

         @remark There is no provision to set the limits of AM/PM field.

         @see elm_datetime_field_limit_set()
         @ingroup Datetime */

         params {
            @in Elm_Datetime_Field_Type fieldtype; /*@ Type of the field. #ELM_DATETIME_YEAR etc. */
            @in int min; /*@ Reference to field's minimum value */
            @in int max; /*@ Reference to field's maximum value */
         }
      }
      field_limit_get @const {
         /*@
         @brief Get the field limits of a field.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Limits can be set to individual fields, independently, except for AM/PM field.
         Any field can display the values only in between these Minimum and Maximum limits unless
         the corresponding time value is restricted from MinTime to MaxTime.
         That is, Min/ Max field limits always works under the limitations of MinTime/ MaxTime.

         @remark There is no provision to set the limits of AM/PM field.

         @see elm_datetime_field_limit_set()
         @ingroup Datetime */
         params {
            @in Elm_Datetime_Field_Type fieldtype; /*@ Type of the field. #ELM_DATETIME_YEAR etc. */
            @out int min; /*@ Reference to field's minimum value */
            @out int max; /*@ Reference to field's maximum value */
         }
      }
      value_min_set {
         /*@
         @brief Set the lower boundary of a field.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Year: years since 1900. Negative value represents year below 1900 (year
         value -30 represents 1870). Year default range is from 70 to 137.

         @remark Month: default value range is from 0 to 11.

         @remark Date: default value range is from 1 to 31 according to the month value.

         @remark Hour: default value will be in terms of 24 hr format (0~23)

         @remark Minute: default value range is from 0 to 59.

         @return @c EINA_TRUE if minimum value is accepted.

         @see elm_datetime_value_min_get()
         @ingroup Datetime */

         return: bool;
         params {
            @in const(struct tm)* mintime; /*@ Time structure containing the minimum time value. */
         }
      }
      value_min_get @const {
         /*@
         @brief Get the lower boundary of a field.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Year: years since 1900. Negative value represents year below 1900 (year
         value -30 represents 1870). Year default range is from 70 to 137.

         @remark Month: default value range is from 0 to 11.

         @remark Date: default value range is from 1 to 31 according to the month value.

         @remark Hour: default value will be in terms of 24 hr format (0~23)

         @remark Minute: default value range is from 0 to 59.

         @return @c EINA_TRUE if minimum value is successfully returned.

         @see elm_datetime_value_min_set()
         @ingroup Datetime */
         return: bool;
         params {
            @inout struct tm mintime; /*@ Time structure. */
         }
      }
      value_set {
         /*@
         @brief Set the current value of a Datetime object.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Year: years since 1900. Negative value represents year below 1900 (year
         value -30 represents 1870). Year default range is from 70 to 137.

         @remark Month: default value range is from 0 to 11.

         @remark Date: default value range is from 1 to 31 according to the month value.

         @remark Hour: default value will be in terms of 24 hr format (0~23)

         @remark Minute: default value range is from 0 to 59.

         @return @c EINA_TRUE if current time is set successfully.

         @see elm_datetime_value_set()
         @ingroup Datetime */

         return: bool;
         params {
            @in const(struct tm)* newtime; /*@ Time structure filled with values to be set. */
         }
      }
      value_get @const {
         /*@
         @brief Get the current value of a Datetime object.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Year: years since 1900. Negative value represents year below 1900 (year
         value -30 represents 1870). Year default range is from 70 to 137.

         @remark Month: default value range is from 0 to 11.

         @remark Date: default value range is from 1 to 31 according to the month value.

         @remark Hour: default value will be in terms of 24 hr format (0~23)

         @remark Minute: default value range is from 0 to 59.

         @return @c EINA_TRUE if current time is returned successfully.

         @see elm_datetime_value_set()
         @ingroup Datetime */
         return: bool;
         params {
            @inout struct tm currtime; /*@ Time structure. */
         }
      }
      field_visible_set {
         /*@
         @brief Set a field to be visible or not.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Setting this API True does not ensure that the field is visible, apart from
         this, the field's format must be present in Datetime overall format.
         If a field's visibility is set to False then it won't appear even though
         its format is present in overall format.
         So if and only if this API is set true and the corresponding field's format
         is present in Datetime format, the field is visible.

         @remark By default the field visibility is set to True.

         @see elm_datetime_field_visible_get()
         @ingroup Datetime */

         params {
            @in Elm_Datetime_Field_Type fieldtype; /*@ Type of the field. #ELM_DATETIME_YEAR etc. */
            @in bool visible; /*@ @c EINA_TRUE field can be visible, @c EINA_FALSE otherwise. */
         }
      }
      field_visible_get @const {
         /*@
         @brief Get whether a field can be visible/not

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @return bool @c EINA_TRUE, if field can be visible. @c EINA_FALSE otherwise.

         @see elm_datetime_field_visible_set()
         @ingroup Datetime */
         return: bool;
         params {
            @in Elm_Datetime_Field_Type fieldtype; /*@ Type of the field. #ELM_DATETIME_YEAR etc */
         }
      }
      value_max_set {
         /*@
         @brief Set the upper boundary of a field.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Year: years since 1900. Negative value represents year below 1900 (year
         value -30 represents 1870). Year default range is from 70 to 137.

         @remark Month: default value range is from 0 to 11.

         @remark Date: default value range is from 1 to 31 according to the month value.

         @remark Hour: default value will be in terms of 24 hr format (0~23)

         @remark Minute: default value range is from 0 to 59.

         @return @c EINA_TRUE if maximum value is accepted.

         @see elm_datetime_value_max_get()
         @ingroup Datetime */

         return: bool;
         params {
            @in const(struct tm)* maxtime; /*@ Time structure containing the maximum time value. */
         }
      }
      value_max_get @const {
         /*@
         @brief Get the upper boundary of a field.

         @if MOBILE @since_tizen 2.3
         @elseif WEARABLE @since_tizen 2.3.1
         @endif

         @remark Year: years since 1900. Negative value represents year below 1900 (year
         value -30 represents 1870). Year default range is from 70 to 137.

         @remark Month: default value range is from 0 to 11.

         @remark Date: default value range is from 1 to 31 according to the month value.

         @remark Hour: default value will be in terms of 24 hr format (0~23)

         @remark Minute: default value range is from 0 to 59.

         @return @c EINA_TRUE if maximum value is returned successfully.

         @see elm_datetime_value_max_set()
         @ingroup Datetime */
         return: bool;
         params {
            @inout struct tm maxtime; /*@ Time structure containing the maximum time value. */
         }
      }
   }
   implements {
      class.constructor;
      Eo.Base.constructor;
      Evas.Object_Smart.add;
      Evas.Object_Smart.del;
      Elm_Widget.theme_apply;
      Elm_Widget.focus_next_manager_is;
      Elm_Widget.focus_next;
      Elm_Widget.disable;
      Elm_Widget.on_focus;
      Elm_Widget.translate;
      Elm_Layout.sizing_eval;
   }
   events {
      changed;
      language,changed;
      access,changed;
      focused;
      unfocused;
   }

}
