Datetime
PUBLISHED
This feature is supported in wearable applications only.
The datetime component displays date and time values.
For more information, see the Datetime [1] API.
Figure: Datetime component
Figure: Datetime hierarchy
Adding a Datetime Component
To create a datetime component:
- Add the datetime component with the
elm_datetime_add()
function. - Select the visible fields with the
elm_datetime_field_visible_set()
function.The visibility of the following fields can be controlled:
ELM_DATETIME_YEAR
: Year fieldELM_DATETIME_MONTH
: Month fieldELM_DATETIME_DATE
: Date fieldELM_DATETIME_HOUR
: Hour fieldELM_DATETIME_MINUTE
: Minute fieldELM_DATETIME_AMPM
: AM/PM field
Using the Datetime Styles
The datetime has the following styles:
datepicker_layout
timepicker_layout
To set the style to, for example, datepicker_layout
:
elm_object_style_set(datetime, "datepicker_layout");
Setting the Datetime Format
The date and time format can be configured with the elm_datetime_format_set()
function using a combination of allowed Libc date format specifiers.
To set the format to "HH : MM":
elm_object_style_set(datetime, "timepicker_layout"); elm_datetime_format_set(datetime, "%d/%b/%Y%I:%M");
For a complete list of available specifiers, see the Datetime [1] API.
Using the Datetime Callbacks
To receive notifications about the datetime events, listen for the following signals:
changed
: The datetime field values are changed.language,changed
: The system locale changes.
In both these signals, the event_info
callback parameter is NULL
.
To register and define a callback for the changed
signal:
{ evas_object_smart_callback_add(datetime, "changed", changed_cb, data); } /* Callback for the "changed" signal */ /* Called when the datetime fields change */ void changed_cb(void *data, Evas_Object *obj, void *event_info) { dlog_print(DLOG_INFO, LOG_TAG, "Datetime field changed. \n"); }