aceUIDateTimePicker

The aceUIDateTimePicker is a widget for selecting a date and / or time. The widget is based on Bootstrap Datepicker version 4.7.14.

Minion

Note that dates are selected in local time but stored in UTC. The date / time picker always shows the selected date according to the time zone of the user.

Configuration

Attribute Description Default
"placeholder" string

A placeholder text shown if a value has not been selected.		 ""
"editable" boolean

Whether or not the field should be editable.		 true
"dtConfig" object

Configuration for the Datepicker instance. See Bootstrap Datepicker options documentation for valid configuration values.		 
{
  "locale": "en",
  "showClose": true,
  "showClear": true,
  "showTodayButton": true,  
  "useCurrent": false
 }

Localization

This widget has localization support.

Localizable configuration properties: placeholder.

The language / locale used by the third-party Datepicker will be the same as that used by other parts of the ACE UI application.

Note

The config option dtConfig.defaultDate is not supported. The value configured for that option will not be saved to the data.

Expected domain objects

This widget expects a single domain object of type long.

The aceUIDateTimePicker widget reads and writes the selected date/time using Unix time in milliseconds, meaning the number of milliseconds since the start of the epoch (00:00:00 Coordinated Universal Time (UTC), Thursday, 1 January 1970). This means that the data type of the field backing storage in the type should be long.

Example template json

{
  "label": "Publishing time",
  "name": "publishingTime",
  "widget": "aceUIDateTimePicker",

  "config": {
    "placeholder": "Select a date and time...",
    "editable": true,

    "dtConfig": {
      "locale":"en"
    }
  },

  "domainObject": "article/publishingTime"
}