JavaScript/jQuery Scheduler - Hidden Week Days

The DevExtreme JavaScript 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).

Also available for:

ASP.NET Core ASP.NET MVC 5

Backend API

$(() => { const dayLabels = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']; let visibleDays = [0, 1, 2, 4, 6]; const VALIDATION_MESSAGE = 'The hiddenWeekDays option cannot hide all days of the week. At least one day must remain visible.'; function computeHiddenWeekDays() { return [0, 1, 2, 3, 4, 5, 6].filter((d) => !visibleDays.includes(d)); } function refreshValidity() { $('.hidden-days-demo').toggleClass('is-invalid', visibleDays.length === 0); } const scheduler = $('#scheduler').dxScheduler({ timeZone: 'America/Los_Angeles', dataSource: new DevExpress.data.ArrayStore({ key: 'id', data, }), views: ['week', 'workWeek', 'month', 'timelineWeek', 'agenda'], hiddenWeekDays: computeHiddenWeekDays(), currentView: 'week', currentDate: new Date(2021, 3, 26), startDayHour: 9, height: 730, }).dxScheduler('instance'); const $optionsPanel = $('.options'); dayLabels.forEach((label, idx) => { const $cb = $('<div class="option"></div>').appendTo($optionsPanel); $cb.dxCheckBox({ text: label, value: visibleDays.includes(idx), onValueChanged(e) { if (e.value) { visibleDays = [...visibleDays, idx]; } else { visibleDays = visibleDays.filter((d) => d !== idx); } refreshValidity(); scheduler.option('hiddenWeekDays', computeHiddenWeekDays()); }, }); }); $('<div class="validation-message"></div>').text(VALIDATION_MESSAGE).appendTo($optionsPanel); refreshValidity(); });

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" 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" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/26.1.3/css/dx.light.css" /> <script src="js/dx.all.js?v=26.1.3"></script> <script src="data.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div class="hidden-days-demo"> <div class="scheduler-container"> <div id="scheduler"></div> </div> <div class="options"> <div class="caption">Visible Week Days</div> </div> </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; }

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'), }, ];

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.