React Scheduler - Hidden Week Days

The DevExtreme Scheduler allows you to exclude specific days of the week (using the hiddenWeekDays property).

Use checkboxes in the options panel to toggle day visibility. A validation message appears if you attempt to hide all seven days (at least one day must remain visible).

TS JS

Backend API

import React, { useCallback, useMemo, useState } from 'react'; import Scheduler, { type SchedulerTypes } from 'devextreme-react/scheduler'; import CheckBox, { type CheckBoxTypes } from 'devextreme-react/check-box'; import { ArrayStore } from 'devextreme-react/common/data'; import { data } from './data.ts'; const dataSource = new ArrayStore({ key: 'id', data, }); const allDays: SchedulerTypes.DayOfWeek[] = [0, 1, 2, 3, 4, 5, 6]; const dayLabels = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']; const defaultVisible: SchedulerTypes.DayOfWeek[] = [0, 1, 2, 4, 6]; const views: SchedulerTypes.Properties['views'] = ['week', 'workWeek', 'month', 'timelineWeek', 'agenda']; const currentDate = new Date(2021, 3, 26); const VALIDATION_MESSAGE = 'The hiddenWeekDays option cannot hide all days of the week. At least one day must remain visible.'; const App = () => { const [visibleDays, setVisibleDays] = useState<SchedulerTypes.DayOfWeek[]>(defaultVisible); const isInvalid = visibleDays.length === 0; const hiddenWeekDays = useMemo( () => allDays.filter((d) => !visibleDays.includes(d)), [visibleDays], ); const onDayToggle = useCallback((dayIndex: SchedulerTypes.DayOfWeek, e: CheckBoxTypes.ValueChangedEvent) => { setVisibleDays((prev) => (e.value ? [...prev, dayIndex] : prev.filter((d) => d !== dayIndex))); }, []); return ( <div className={`hidden-days-demo${isInvalid ? ' is-invalid' : ''}`}> <div className="scheduler-container"> <Scheduler timeZone="America/Los_Angeles" dataSource={dataSource} views={views} hiddenWeekDays={hiddenWeekDays} defaultCurrentView="week" defaultCurrentDate={currentDate} startDayHour={9} height={730} /> </div> <div className="options"> <div className="caption">Visible Week Days</div> {dayLabels.map((label, idx) => ( <div className="option" key={label}> <CheckBox text={label} value={visibleDays.includes(idx as SchedulerTypes.DayOfWeek)} onValueChanged={(e) => onDayToggle(idx as SchedulerTypes.DayOfWeek, e)} /> </div> ))} <div className="validation-message"> {VALIDATION_MESSAGE} </div> </div> </div> ); }; export default App;

import React, { useCallback, useMemo, useState } from 'react'; import Scheduler from 'devextreme-react/scheduler'; import CheckBox from 'devextreme-react/check-box'; import { ArrayStore } from 'devextreme-react/common/data'; import { data } from './data.js'; const dataSource = new ArrayStore({ key: 'id', data, }); const allDays = [0, 1, 2, 3, 4, 5, 6]; const dayLabels = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']; const defaultVisible = [0, 1, 2, 4, 6]; const views = ['week', 'workWeek', 'month', 'timelineWeek', 'agenda']; const currentDate = new Date(2021, 3, 26); const VALIDATION_MESSAGE = 'The hiddenWeekDays option cannot hide all days of the week. At least one day must remain visible.'; const App = () => { const [visibleDays, setVisibleDays] = useState(defaultVisible); const isInvalid = visibleDays.length === 0; const hiddenWeekDays = useMemo( () => allDays.filter((d) => !visibleDays.includes(d)), [visibleDays], ); const onDayToggle = useCallback((dayIndex, e) => { setVisibleDays((prev) => (e.value ? [...prev, dayIndex] : prev.filter((d) => d !== dayIndex))); }, []); return ( <div className={`hidden-days-demo${isInvalid ? ' is-invalid' : ''}`}> <div className="scheduler-container"> <Scheduler timeZone="America/Los_Angeles" dataSource={dataSource} views={views} hiddenWeekDays={hiddenWeekDays} defaultCurrentView="week" defaultCurrentDate={currentDate} startDayHour={9} height={730} /> </div> <div className="options"> <div className="caption">Visible Week Days</div> {dayLabels.map((label, idx) => ( <div className="option" key={label} > <CheckBox text={label} value={visibleDays.includes(idx)} onValueChanged={(e) => onDayToggle(idx, e)} /> </div> ))} <div className="validation-message">{VALIDATION_MESSAGE}</div> </div> </div> ); }; export default App;

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

import type { SchedulerTypes } from 'devextreme-react/scheduler'; export const data: SchedulerTypes.Appointment[] = [ { id: 1, text: 'Website Re-Design Plan', startDate: new Date('2021-04-26T16:30:00.000Z'), endDate: new Date('2021-04-26T18:30:00.000Z'), }, { id: 2, text: 'Book Flights to San Fran for Sales Trip', startDate: new Date('2021-04-26T19:00:00.000Z'), endDate: new Date('2021-04-26T20:00:00.000Z'), allDay: true, }, { id: 3, text: 'Install New Router in Dev Room', startDate: new Date('2021-04-26T21:30:00.000Z'), endDate: new Date('2021-04-26T22:30:00.000Z'), }, { id: 4, text: 'Approve Personal Computer Upgrade Plan', startDate: new Date('2021-04-27T17:00:00.000Z'), endDate: new Date('2021-04-27T18:00:00.000Z'), }, { id: 5, text: 'Final Budget Review', startDate: new Date('2021-04-27T19:00:00.000Z'), endDate: new Date('2021-04-27T20:35:00.000Z'), }, { id: 6, text: 'New Brochures', startDate: new Date('2021-04-27T21:30:00.000Z'), endDate: new Date('2021-04-27T22:45:00.000Z'), }, { id: 7, text: 'Install New Database', startDate: new Date('2021-04-28T16:45:00.000Z'), endDate: new Date('2021-04-28T18:15:00.000Z'), }, { id: 8, text: 'Approve New Online Marketing Strategy', startDate: new Date('2021-04-28T19:00:00.000Z'), endDate: new Date('2021-04-28T21:00:00.000Z'), }, { id: 9, text: 'Upgrade Personal Computers', startDate: new Date('2021-04-28T22:15:00.000Z'), endDate: new Date('2021-04-28T23:30:00.000Z'), }, { id: 10, text: 'Customer Workshop', startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T19:00:00.000Z'), allDay: true, }, { id: 11, text: 'Prepare 2021 Marketing Plan', startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T20:30:00.000Z'), }, { id: 12, text: 'Brochure Design Review', startDate: new Date('2021-04-29T21:00:00.000Z'), endDate: new Date('2021-04-29T22:30:00.000Z'), }, { id: 13, text: 'Create Icons for Website', startDate: new Date('2021-04-30T17:00:00.000Z'), endDate: new Date('2021-04-30T18:30:00.000Z'), }, { id: 14, text: 'Upgrade Server Hardware', startDate: new Date('2021-04-30T21:30:00.000Z'), endDate: new Date('2021-04-30T23:00:00.000Z'), }, { id: 15, text: 'Submit New Website Design', startDate: new Date('2021-04-30T23:30:00.000Z'), endDate: new Date('2021-05-01T01:00:00.000Z'), }, { id: 16, text: 'Launch New Website', startDate: new Date('2021-04-30T19:20:00.000Z'), endDate: new Date('2021-04-30T21:00:00.000Z'), }, ];

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

export const data = [ { id: 1, text: 'Website Re-Design Plan', startDate: new Date('2021-04-26T16:30:00.000Z'), endDate: new Date('2021-04-26T18:30:00.000Z'), }, { id: 2, text: 'Book Flights to San Fran for Sales Trip', startDate: new Date('2021-04-26T19:00:00.000Z'), endDate: new Date('2021-04-26T20:00:00.000Z'), allDay: true, }, { id: 3, text: 'Install New Router in Dev Room', startDate: new Date('2021-04-26T21:30:00.000Z'), endDate: new Date('2021-04-26T22:30:00.000Z'), }, { id: 4, text: 'Approve Personal Computer Upgrade Plan', startDate: new Date('2021-04-27T17:00:00.000Z'), endDate: new Date('2021-04-27T18:00:00.000Z'), }, { id: 5, text: 'Final Budget Review', startDate: new Date('2021-04-27T19:00:00.000Z'), endDate: new Date('2021-04-27T20:35:00.000Z'), }, { id: 6, text: 'New Brochures', startDate: new Date('2021-04-27T21:30:00.000Z'), endDate: new Date('2021-04-27T22:45:00.000Z'), }, { id: 7, text: 'Install New Database', startDate: new Date('2021-04-28T16:45:00.000Z'), endDate: new Date('2021-04-28T18:15:00.000Z'), }, { id: 8, text: 'Approve New Online Marketing Strategy', startDate: new Date('2021-04-28T19:00:00.000Z'), endDate: new Date('2021-04-28T21:00:00.000Z'), }, { id: 9, text: 'Upgrade Personal Computers', startDate: new Date('2021-04-28T22:15:00.000Z'), endDate: new Date('2021-04-28T23:30:00.000Z'), }, { id: 10, text: 'Customer Workshop', startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T19:00:00.000Z'), allDay: true, }, { id: 11, text: 'Prepare 2021 Marketing Plan', startDate: new Date('2021-04-29T18:00:00.000Z'), endDate: new Date('2021-04-29T20:30:00.000Z'), }, { id: 12, text: 'Brochure Design Review', startDate: new Date('2021-04-29T21:00:00.000Z'), endDate: new Date('2021-04-29T22:30:00.000Z'), }, { id: 13, text: 'Create Icons for Website', startDate: new Date('2021-04-30T17:00:00.000Z'), endDate: new Date('2021-04-30T18:30:00.000Z'), }, { id: 14, text: 'Upgrade Server Hardware', startDate: new Date('2021-04-30T21:30:00.000Z'), endDate: new Date('2021-04-30T23:00:00.000Z'), }, { id: 15, text: 'Submit New Website Design', startDate: new Date('2021-04-30T23:30:00.000Z'), endDate: new Date('2021-05-01T01:00:00.000Z'), }, { id: 16, text: 'Launch New Website', startDate: new Date('2021-04-30T19:20:00.000Z'), endDate: new Date('2021-04-30T21:00:00.000Z'), }, ];

<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/26.1.3/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>

.hidden-days-demo { display: flex; gap: 20px; } .scheduler-container { flex: 1; min-width: 0; } .options { display: flex; flex-direction: column; flex-shrink: 0; width: 220px; box-sizing: border-box; padding: 20px; background-color: rgba(191, 191, 191, 0.15); gap: 12px; } .caption { font-weight: 500; font-size: 18px; } .option { display: flex; flex-direction: column; } .validation-message { display: none; margin-top: 8px; padding: 10px 12px; background: #fdf3f4; border-left: 3px solid #c50f1f; border-radius: 4px; color: #c50f1f; font-size: 13px; line-height: 1.4; } .hidden-days-demo.is-invalid .validation-message { display: block; } .hidden-days-demo.is-invalid .option .dx-checkbox-icon { border-color: #c50f1f; } .hidden-days-demo.is-invalid .dx-scheduler-work-space { opacity: 0.4; pointer-events: none; }

To hide specific days of the week, assign an array of day indexes to the hiddenWeekDays property. Index values follow the JavaScript date.getDay() convention:

0 - Sunday
1 - Monday
2 - Tuesday
3 - Wednesday
4 - Thursday
5 - Friday
6 - Saturday

The property works across multiple view types. To hide days of the week from a specific view, use the same property within the view configuration object.