🚀 We value your input in shaping our future plans. Take charge and have a direct impact by participating in our survey.

Date Picker

Allows users to select a single date or a range of dates depending on the use case.


Default date picker

HTML React
    <script type="module" src="https://cdn.jsdelivr.net/npm/@govtechsg/sgds-web-component@1.2.3/components/Datepicker/index.umd.js">
View on React storybook


Date Picker Anatomy
  1. Month: Allows the user to select the month.
  2. Year: Allows the user to select the year.
  3. Forward/backward chevrons: Allows the user to move forward or backwards by month within the selected year.


Date Picker Spacing

Within the calendar
Ensure that there is a minimum of 24px vertical and horizontal spacing.

Usage guidelines

Date Picker should be used:

  • When you want users to select a single date or a range of dates.

Date Picker should not be used:

  • where the context of the calendar is not important.

Usability guidelines

Be relevant and clear
Date pickers can display past, present or future dates, display as relevant to the task as possible. Clearly indicate important dates as well; current and selected dates.

Target touch size
Ensure that the target touch size is big enough, at least 32 x 32dp, This will reduce the chance of users hitting the wrong target that potentially cause they to complete the action wrongly without realising.

Last updated 28 November 2023

Latest version 2.3.3