Default

DD MMM YYYY once selected

States

Choose a date after today.

PropTypeDefaultRequiredDescription
labelstring—NoField label.
hintstring—NoHelper text shown below the field.
errorstring—NoError message — replaces the hint.
minstring—NoEarliest selectable date, as YYYY-MM-DD.
maxstring—NoLatest selectable date, as YYYY-MM-DD.
Do
  • Constrain min/max when a date range is actually invalid (e.g. a birth date can’t be in the future).
  • Display the chosen date as DD MMM YYYY everywhere else in the product (see Foundations → Data Formatting).
Don't
  • Build a custom calendar widget unless the native picker genuinely can’t express the interaction (e.g. a date range).
  • Accept free-text date entry without a picker — format ambiguity causes real data errors.