JavaScript/jQuery Scheduler - Time Zone Support

DevExtreme JavaScript Scheduler allows you to specify time zones used for the component and associated events/appointments. In this demo, you can change the time zone using the SelectBox positioned above the JavaScript Scheduler. A getTimeZones() method call populates the SelectBox with appropriate values.

Backend API

$(() => { const currentDate = new Date(2021, 3, 27); const getTimeZones = (date) => DevExpress.utils.getTimeZones(date, locations) const timeZones = getTimeZones(currentDate); const scheduler = $('#scheduler').dxScheduler({ dataSource: data, views: ['workWeek'], timeZone: timeZones[0].id, currentView: 'workWeek', currentDate, startDayHour: 8, height: 600, editing: { allowTimeZoneEditing: true, }, onOptionChanged(e) { if (e.name === 'currentDate') { locationSwitcher.option('items', getTimeZones(e.value)); } }, onAppointmentFormOpening(e) { const { form } = e; const startDateTimezoneEditor = form.getEditor('startDateTimeZone'); const endDateTimezoneEditor = form.getEditor('endDateTimeZone'); const startDateDataSource = startDateTimezoneEditor.option('dataSource'); const endDateDataSource = endDateTimezoneEditor.option('dataSource'); startDateDataSource.filter(['id', 'contains', 'Europe']); endDateDataSource.filter(['id', 'contains', 'Europe']); startDateDataSource.load(); endDateDataSource.load(); }, }).dxScheduler('instance'); const locationSwitcher = $('#location-switcher').dxSelectBox({ items: timeZones, displayExpr: 'title', inputAttr: { 'aria-label': 'Time zone' }, valueExpr: 'id', width: 240, value: timeZones[0].id, onValueChanged(data) { scheduler.option('timeZone', data.value); }, }).dxSelectBox('instance'); });

<!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/25.1.5/css/dx.light.css" /> <script src="js/dx.all.js?v=25.1.5"></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="option"> <span>Office Time Zone</span> <div id="location-switcher"></div> </div> <div id="scheduler"></div> </div> </body> </html>

.option { display: flex; } .option > span { display: flex; align-items: center; margin-right: 10px; } .dx-scheduler { margin-top: 20px; }

const data = [ { text: 'Stand-up meeting', startDate: '2021-04-26T15:30:00.000Z', endDate: '2021-04-26T15:45:00.000Z', recurrenceRule: 'FREQ=DAILY', }, { text: 'Book Flights to San Fran for Sales Trip', startDate: '2021-04-28T18:00:00.000Z', endDate: '2021-04-28T19:00:00.000Z', }, { text: 'New Brochures', startDate: '2021-04-30T18:30:00.000Z', endDate: '2021-04-30T18:45:00.000Z', }, { text: 'Website Re-Design Plan', startDate: '2021-04-27T12:30:00.000Z', endDate: '2021-04-27T13:30:00.000Z', }, { text: 'Book Flights to San Fran for Sales Trip', startDate: '2021-04-28T16:00:00.000Z', endDate: '2021-04-28T15:00:00.000Z', }, { text: 'Prepare 2021 Marketing Plan', startDate: '2021-04-26T07:00:00.000Z', endDate: '2021-04-26T09:30:00.000Z', }, { text: 'Launch New Website', startDate: '2021-04-28T08:00:00.000Z', endDate: '2021-04-28T10:00:00.000Z', }, { text: 'Submit New Website Design', startDate: '2021-04-29T09:30:00.000Z', endDate: '2021-04-29T11:00:00.000Z', }, { text: 'Upgrade Server Hardware', startDate: '2021-04-30T06:30:00.000Z', endDate: '2021-04-30T08:00:00.000Z', }, { text: 'Approve New Online Marketing Strategy', startDate: '2021-04-30T11:00:00.000Z', endDate: '2021-04-30T12:30:00.000Z', }, { text: 'Final Budget Review', startDate: '2021-04-27T09:00:00.000Z', endDate: '2021-04-27T10:35:00.000Z', }]; const locations = ['Europe/London', 'Europe/Berlin', 'Europe/Helsinki'];

To define the time zone at the component level, assign an IANA time zone value to the timeZone property.

To modify time zones used for appointments, enable the editing.allowTimeZoneEditing option. Our JavaScript Scheduler supports different time zones for appointment start and end dates (startDateTimeZone and endDateTimeZone appointment properties).