<DatePicker> is a UI component that lets users select a date from a pre-configured range.

See also: TimePicker.

<<< @/../examples/src/ui/DatePicker/template.xml#example

<DatePicker
  year="2023"
  month="8"
  day="28"
  date="{{ date }}"
  minDate="{{ minDate }}"
  maxDate="{{ maxDate }}"
/>

date: Date

Gets or sets the complete date.

minDate: Date

Gets or sets the earliest possible date to select.

maxDate: Date

Gets or sets the latest possible date to select.

day: number

Gets or sets the day of the month.

month: number

Gets or sets the month.

year: number

Gets or sets the year.

iosPreferredDatePickerStyle: UIDatePickerStyle

Gets or set the UIDatePickerStyle of the DatePicker in iOS 13.4+.

Default value: 0 (automatic).

Valid values:

• 0 = automatic: system picks the concrete style based on the current platform and DatePicker mode.
• 1 = wheels: the DatePicker displays as a wheel picker.
• 2 = compact : the DatePicker displays as a label that when tapped displays a calendar-style editor.
• 3 = inline : the DatePickers displays as an inline, editable field

on('dateChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New date:', args.value)
})

Emitted when the selected date changes.

See PropertyChangeData.

on('minDateChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New minDate:', args.value)
})

Emitted when the minimum date changes.

See PropertyChangeData.

on('maxDateChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New maxDate:', args.value)
})

Emitted when the maximum date changes.

See PropertyChangeData.

on('dayChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New day:', args.value)
})

Emitted when the day changes.

See PropertyChangeData.

on('monthChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New month:', args.value)
})

Emitted when the month changes.

See PropertyChangeData.

on('yearChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New year:', args.value)
})

Emitted when the year changes.

See PropertyChangeData.

• Android: android.widget.DatePicker
• iOS: UIDatePicker