Datepicker

Bootstrap 5 Datepicker

Date picker is a plugin that adds the function of selecting time without the necessity of using custom JavaScript code.

Note: Read the API tab to find all available options and advanced customization


Basic example

The datepicker allows users to enter a date either through text input, or by choosing a date from the calendar. Date pickers can be embedded into dialogs on mobile and text field dropdowns on desktop.

        
            
          <div class="form-outline datepicker">
            <input type="text" class="form-control" id="exampleDatepicker11" />
            <label for="exampleDatepicker11" class="form-label">Select a date</label>
          </div>
        
        
    

Inline version

Use the data-mdb-inline="true" attribute to initialize and set the default date for an inline datepicker inside a block element.

        
            
          <div class="form-outline datepicker" data-mdb-inline="true">
            <input type="text" class="form-control" id="exampleDatepicker2" />
            <label for="exampleDatepicker2" class="form-label">Select a date</label>
          </div>
        
        
    

Translations

The picker can be customized to add support for internationalization. Modify the component options to add translations.

        
            
          <div class="form-outline datepicker-translated">
            <input type="text" class="form-control" id="exampleDatepicker3" />
            <label for="exampleDatepicker3" class="form-label">Select a date</label>
          </div>
        
        
    
        
            
            const datepickerTranslated = document.querySelector('.datepicker-translated');
            new mdb.Datepicker(datepickerTranslated, {
              title: 'Datum auswählen',
              monthsFull: ['Januar', 'Februar', 'März', 'April', 'Mai', 'Juni', 'Juli', 'August', 'September', 'Oktober', 'November', 'Dezember'],
              monthsShort: ['Jan', 'Feb', 'Mär', 'Apr', 'Mai', 'Jun', 'Jul', 'Aug', 'Sep', 'Okt', 'Nov','Dez'],
              weekdaysFull: ['Sonntag', 'Montag', 'Dienstag', 'Mittwoch', 'Donnerstag', 'Freitag', 'Samstag'],
              weekdaysShort: ['Son', 'Mon', 'Die', 'Mit', 'Don', 'Fre', 'Sam'],
              weekdaysNarrow: ['S', 'M', 'D', 'M', 'D', 'F', 'S'],
              okBtnText: 'Ok',
              clearBtnText: 'Klar',
              cancelBtnText: 'Schließen',
            });
        
        
    

Formats

Use format option to display date in a human-friendly format.

        
            
          <div class="form-outline datepicker" data-mdb-format="dd, mmm, yyyy">
            <input type="text" class="form-control" id="exampleDatepicker4" placeholder="dd, mmm, yyyy" />
            <label for="exampleDatepicker4" class="form-label">Select a date</label>
          </div>
        
        
    

Formatting rules

The following rules can be used to format any date:

Note: When using ddd and dddd formats, you need to also provide d or dd. For example: data-mdb-format="ddd, dd, mmm, yyyy"

Rule Description Result
d Date of the month 1 – 31
dd Date of the month with a leading zero 01 – 31
ddd Day of the week in short form Sun – Sat
dddd Day of the week in full form Sunday – Saturday
m Month of the year 1 – 12
mm Month of the year with a leading zero 01 – 12
mmm Month name in short form Jan – Dec
mmmm Month name in full form January – December
yy Year in short form * 00 – 99
yyyy Year in full form 2000 – 2999

Date limits

Set the minimum and maximum selectable dates with the min and max options.

        
            
          <div class="form-outline datepicker-with-limits">
            <input type="text" class="form-control" id="exampleDatepicker5" />
            <label for="exampleDatepicker5" class="form-label">Select a date</label>
          </div>
        
        
    
        
            
          const datepickerWithLimits = document.querySelector('.datepicker-with-limits');
          new mdb.Datepicker(datepickerWithLimits, {
            min: new Date(2020, 5, 10),
            max: new Date(2022, 5, 20)
          });
        
        
    

Disable past

Use the disablePast option to disallow past date selection.

        
            
          <div class="form-outline datepicker-disable-past">
            <input type="text" class="form-control" id="exampleDatepicker6" />
            <label for="exampleDatepicker6" class="form-label">Select a date</label>
          </div>
        
        
    
        
            
          const datepickerDisablePast = document.querySelector('.datepicker-disable-past');
          new mdb.Datepicker(datepickerDisablePast, {
            disablePast: true
          });
        
        
    

Disable future

Use the disableFuture option to disallow past date selection.

        
            
          <div class="form-outline datepicker-disable-future">
            <input type="text" class="form-control" id="exampleDatepicker7" />
            <label for="exampleDatepicker7" class="form-label">Select a date</label>
          </div>
        
        
    
        
            
          const datepickerDisableFuture = document.querySelector('.datepicker-disable-future');
          new mdb.Datepicker(datepickerDisableFuture, {
            disableFuture: true
          });
        
        
    

Disabled dates

The filter option accept function in which you can specify conditions for date filtering. A result of true indicates that the date should be valid and a result of false indicates that it should be disabled. In the following example all saturdays and sundays will be disabled.

        
            
          <div class="form-outline datepicker-with-filter">
            <input type="text" class="form-control" id="exampleDatepicker8" />
            <label for="exampleDatepicker8" class="form-label">Select a date</label>
          </div>
        
        
    
        
            
          const datepickerWithFilter = document.querySelector('.datepicker-with-filter');

          const filterFunction = (date) => {
            const isSaturday = date.getDay() === 6;
            const isSunday = date.getDay() === 0;

            return !isSaturday && !isSunday;
          }

          new mdb.Datepicker(datepickerWithFilter, { filter: filterFunction });
        
        
    

Input toggle

Add data-mdb-toggle="datepicker" to the input element to enable toggling on input click. It is also possible to set toggleButton option to false to remove the toggle button.

        
            
          <div class="form-outline datepicker" data-mdb-toggle-button="false">
            <input type="text" class="form-control" id="exampleDatepicker13" data-mdb-toggle="datepicker" />
            <label for="exampleDatepicker13" class="form-label">Select a date</label>
          </div>
        
        
    

Custom toggle icon

You can customize the toggle icon by adding a toggle button template to the component HTML.

        
            
          <div class="form-outline datepicker" data-mdb-toggle-button="false">
            <input type="text" class="form-control" id="exampleDatepicker15" />
            <label for="exampleDatepicker15" class="form-label">Select a date</label>
            <button class="datepicker-toggle-button" data-mdb-toggle="datepicker">
              <i class="fas fa-calendar datepicker-toggle-icon"></i>
            </button>
          </div>
        
        
    

Accessibility

We added proper aria attributes to the datepicker controls to make the component accessible. It's possible to change the values of those attributes by modyfing the component options:

        
            
            okBtnLabel: 'Confirm selection',
            clearBtnLabel: 'Clear selection',
            cancelBtnLabel: 'Cancel selection',
            nextMonthLabel: 'Next month',
            prevMonthLabel: 'Previous month',
            nextYearLabel: 'Next year',
            prevYearLabel: 'Previous year',
            nextMultiYearLabel: 'Next 24 years',
            prevMultiYearLabel: 'Previous 24 years',
            switchToMultiYearViewLabel: 'Choose year and month',
            switchToMonthViewLabel: 'Choose date',
            switchToDayViewLabel: 'Choose date',
          
        
    

Datepicker - API


Usage

Via data attributes

        
            
        <div class="form-outline datepicker">
          <input type="text" class="form-control" id="exampleDatepicker1" />
          <label for="exampleDatepicker1" class="form-label">Select a date</label>
        </div>
      
        
    

Via JavaScript

        
            
        const options = {
          format: 'dd-mm-yyyy'
        }
        const myDatepicker = new mdb.Datepicker(document.getElementById('myDatepicker'), options)
      
        
    

Options

Name Type Default Description
cancelBtnLabel String 'Cancel selection' Changes cancel button aria label
cancelBtnText String 'Cancel' Changes cancel button text
clearBtnLabel String 'Clear selection' Changes clear button aria label
clearBtnText String 'Clear' Changes clear button text
container String 'body'

Allows to set the parent element for the datepicker.

disablePast Boolean false Disables selection of past dates
disableFuture Boolean false Disables selection of future dates
filter Function - Disables dates that meet the specified condition
format String 'dd/mm/yyyy' Changes date format displayed in input
inline Boolean false Changes datepicker display mode to inline (dropdown)
max Date - Changes max available date
min Date - Changes min available date
monthsFull Array [ 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December', ] Changes array of months full names
monthsShort Array ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'] Changes array of months short names
okBtnLabel String 'Confirm selection' Changes ok button aria label
nextMonthLabel String 'Next month' Changes next button aria label in days view
nextMultiYearLabel String 'Next 24 years' Changes next button aria label in years view
nextYearLabel String 'Next year' Changes next button aria label in months view
okBtnText String 'Ok' Changes ok button text
prevMonthLabel String 'Previous month' Changes previous button aria label in days view
prevMultiYearLabel String 'Previous 24 years' Changes previous button aria label in years view
prevYearLabel String 'Previous year' Changes previous button aria label in months view
switchToDayViewLabel String 'Choose date' Changes view change button aria label in years view
switchToMonthViewLabel String 'Choose date' Changes view change button aria label in months view
switchToMultiYearViewLabel String 'Choose year and month' Changes view change button aria label in days view
startDate Date - Changes default date to which datepicker will navigate
startDay Number 0 Changes default start day (0 for Sunday, 1 for Monday...)
title String 'Select date' Changes datepicker title
weekdaysFull Array ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'] Changes array of weekdays full names
weekdaysNarrow Array ['S', 'M', 'T', 'W', 'T', 'F', 'S'] Changes array of weekdays narrow names
weekdaysShort Array ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'] Changes array of weekdays short names
view String 'days' Changes default datepicker view (days/years/months)

Methods

Name Description Example
open Manually opens a datepicker myDatepicker.open()
close Manually closes a datepicker myDatepicker.close()
dispose Disposes a datepicker instance myDatepicker.dispose()
getInstance Static method which allows you to get the datepicker instance associated to a DOM element. Datepicker.getInstance(datepickerEl)
getOrCreateInstance Static method which returns the datepicker instance associated to a DOM element or create a new one in case it wasn't initialized. Datepicker.getOrCreateInstance(datepickerEl)
update Updates options of a datepicker instance. datepicker.update({inline: true})
        
            
            const datepickerEl = document.getElementById('myDatepicker')
            const datepicker = new mdb.Datepicker(myModalEl)
            datepicker.open()
          
        
    

Events

Name Description
open.mdb.datepicker This event fires immediately when the datepicker is opened.
close.mdb.datepicker This event fires immediately when the datepicker is closed.
dateChange.mdb.datepicker This event fires immediately when the new date is selected.
        
            
            const myDatepicker = document.getElementById('myDatepicker')
            myDatepicker.addEventListener('open.mdb.datepicker', (e) => {
              // do something...
            })
          
        
    

Import

MDB UI KIT also works with module bundlers. Use the following code to import this component:

        
            
        import { Datepicker } from 'mdb-ui-kit';