Zur Navigation Zum Inhalt Kontakt Menu Find component Overview Lean 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 Komponenten Overview Base Informationen Overview Base Components Sense & Purpose Community Assets Instructions Power-Apps Digital banner ads SAP Design Guidelines App Icons 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

Find component

Lean

Basics Brand Brand Divider Divider Icon Icon Text Text Typografie Typografie Components Accordion Accordion Autocompletion Autocompletion Breadcrumb Breadcrumb Button Button Buttonbar Buttonbar Checkbox Checkbox Chip Chip Contextmenu Contextmenu Datepicker Datepicker Dialog Dialog Fieldset Fieldset Fileselector Fileselector Filter Filter Header Header Link Link Loading Indicator Loading Indicator Menuitem Menuitem Notification Notification Pagination Pagination Processflow Processflow Radiobutton Radiobutton Select (Dropdown) Select (Dropdown) Sidebar Sidebar Slider Slider Status Status Tab Tab Table Table Tag Tag Textarea Textarea Textexpand Textexpand Textfield Textfield Timefield Timefield Toggle Toggle Tooltip Tooltip Tree Tree Usermenu Usermenu
Imprint Contact Cookie settings