Principles Foundation Accessibility Design System Guidelines Deutsch Français Italiano English Our design principles User-centred Recognisable Inclusive Reduced Holistic Self-explanatory Task-oriented Appropriate SBB Brand portal Logo Digital clock Rights of use Base colors Functional colors Off brand colors Icons Timetable icons Pictograms About accessibility Über diesen Guide Contact Further information Product Owner User Research Interaction Design Visual Design Development Content Design Testing What is a design system? Designing Coding FAQ Help Process Contribution Contact Overview Base Components Overview Releases Design Tokens Components Overview Base Informationen Overview Base Components Sense & Purpose Community Assets Instructions App Icons Power-Apps Digital banner ads SAP Design Guidelines Datepicker

Overview

What does the component do?

  • It is used for the entry of a date.

When should the component be used?

  • Whenever a date value is required from the user.

Rules

  • Date details are always single-line.
  • The date selection always has a label.
  • A question mark in the circle – in addition to the label – can be used for detailed explanations. A tooltip opens when clicking on this question mark.
  • The date can be entered by hand by clicking in the date field.
    • Manual entry allows the following entries, which are automatically formatted correctly by the component (e.g. 1 January 2020):
      • '010120'
      • '1.1.20'
      • '01.01.20'
  • When the calendar icon is clicked on, a calendar layer opens to select the date. Clicking outside of the calendar layer closes it again.
  • Individual days or entire date ranges can be deactivated in the calendar layer.
  • The navigation arrows in the calendar layer (month/year) are only shown if a preceding/subsequent date can be selected.
  • If the focus is on the calendar layer, it can be operated by keyboard as follows:
    • Arrow keys: Changing the marked day.
    • Space key / Enter: Selection of the marked day.
  • The selected date is usually displayed in the format "Weekday, DD.MM.YYYY" (example "Fr, 04.08.2017"). The display of the weekday is optional.
 States and variants

States

The component has the following states:

  • Default
  • Placeholder
  • Focused
  • Disabled
  • Error
  • Mandatory
  • Readonly

Variants

Default

Image of a date picker

With scroll function

Image of a date picker with scroll function
  • The navigation arrows are only shown if a preceding/subsequent date can be selected.

Date range

  • Two date pickers are combined to select a date range.
  • If the from date is selected via the calendar layer and the to date has not yet been defined, the calendar layer of the to field opens. If a to date has already been selected, the calendar layer does not open.
  • If the user selects a from date > to date, the to date is deleted and its calendar layer is shown.
  • If both dates are shown, the selected range is entered in the calendar in colour.

Date of birth

Image of a date picker, date of birth

Calender Layer (date picker)

Image of a date picker, calender layer

The tab sequence within the calender layer is defined as follows:

  1. Previous month
  2. Next month
  3. Previous year
  4. Next year
  5. range of the individual days. If the focus is on the range of days, it is possible to navigate left, right, up and down within the days using the arrow keys.

Specifications

DesignCode
Contact

Do you have any questions? Maybe our FAQ or our help will be helpful, otherwise you can post your question on the corresponding board on Github.

Imprint Contact Data privacy Cookie settings