ionic
  1. ionic-datetime

Ionic DateTime

The Ionic DateTime component provides a user-friendly interface for selecting dates and times. It allows you to easily capture complex date/time information and validate user input. The component uses the native date and time pickers of the device/platform, which ensures a seamless user experience across all devices.

Syntax

<ion-datetime
  [displayFormat]="string"
  [min]="string"
  [max]="string"
  [cancelText]="string"
  [doneText]="string"
  [(ngModel)]="dateValue">
</ion-datetime>

Example

<ion-datetime
  displayFormat="MMM DD, YYYY"
  min="2013"
  max="2022"
  cancelText="Cancel"
  doneText="Done"
  [(ngModel)]="myDate">
</ion-datetime>

Output

The Ionic DateTime component can output the selected date and time as a string, a timestamp, or a JavaScript Date object.

Explanation

The displayFormat attribute specifies the format in which the date and time will be displayed to the user. The min and max attributes specify the minimum and maximum values that the user can select. The cancelText and doneText attributes allow you to customize the labels of the cancel and done buttons.

The two-way binding [(ngModel)] is used to associate the selected value with a model property (dateValue in the example above).

Use

The Ionic DateTime component is typically used in forms, where you want to capture a date or time from the user.

Important Points

  • The displayFormat attribute is required.
  • The min and max attributes should be in the format of the displayFormat, otherwise date/time selection might behave unexpectedly.
  • The doneText attribute is set to "OK" by default on devices that use the iOS platform.

Summary

The Ionic DateTime component provides an easy way to capture date and time information in a user-friendly way. With several configurable attributes, it is flexible enough to meet a wide range of requirements.

Published on: