Skip to content
+

Date Calendar

The Date Calendar component lets users select a date without any input or popper / modal.

Basic usage

SMTWTFS
Press Enter to start editing

Uncontrolled vs. controlled value

The value of the component can be uncontrolled or controlled.

Uncontrolled calendar

SMTWTFS

Controlled calendar

SMTWTFS
Press Enter to start editing

Form props

The component can be disabled or read-only.

disabled

SMTWTFS

readOnly

SMTWTFS
Press Enter to start editing

Views

The component can contain three views: day, month, and year. By default, only the day and year views are enabled.

You can customize the enabled views using the views prop. Views will appear in the order they're included in the views array.

"year", "month" and "day"

SMTWTFS

"day"

SMTWTFS

"month" and "year"

Press Enter to start editing

Choose the initial year / month

If value or defaultValue contains a valid date, this date will be used to choose which month to render in the day view and which year to render in the month view. If both value and defaultValue contain no valid date, the component will try to find a month and year that satisfies the validation rules.

You can override this date using the referenceDate, in the example below the calendar renders April 2022 even though no date is visually selected:

SMTWTFS
Press Enter to start editing

Month and Year Calendar

If you only need the year view or the month view, you can use the YearCalendar / MonthCalendar components:

YearCalendar

MonthCalendar

Day view customization

Show additional days

To show all days of displayed weeks, including those outside of the current month, use showDaysOutsideCurrentMonth.

By default, only weeks of the current month are displayed, but you can provide a total number of week to display with fixedWeekNumber prop. This value is usually set to 6 for Gregorian calendars, because months display can vary between 4 and 6 weeks.

SMTWTFS
Press Enter to start editing

Display week number

To display week number, use the displayWeekNumber. You can customize the calendar week header by using the localization key localeText.calendarWeekNumberHeaderText. You can also customize what's rendered as a calendar week number, using a callback for the localization key localeText.calendarWeekNumberText.

#SMTWTFS
Press Enter to start editing

Week picker

You can select the whole week using the day component slot:

#SMTWTFS
Press Enter to start editing

Dynamic data

Sometimes it may be necessary to display additional info right in the calendar. The following demo shows how to add a badge on some day based on server side data:

SMTWTFS
Press Enter to start editing

Validation

You can find the documentation in the Validation page.

Localization

You can find the documentation about localization in the Date format and localization and Translated components.

API

See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.