Vue Scheduler - Time Zone Support

DevExtreme 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 Scheduler. A getTimeZones() method call populates the SelectBox with appropriate values.

Backend API

<template> <div> <div class="option"> <span>Office Time Zone</span> <DxSelectBox :items="timeZones" v-model:value="currentTimeZone" :input-attr="{ 'aria-label': 'Time zone' }" :width="240" display-expr="title" value-expr="id" /> </div> <DxScheduler :data-source="dataSource" :current-date="currentDate" :views="views" :height="600" :start-day-hour="8" :time-zone="currentTimeZone" current-view="workWeek" :on-appointment-form-opening="onAppointmentFormOpening" :on-option-changed="onOptionChanged" > <DxEditing :allow-time-zone-editing="true" /> </DxScheduler> </div> </template> <script setup lang="ts"> import { ref } from 'vue'; import DxScheduler, { DxEditing, type DxSchedulerTypes } from 'devextreme-vue/scheduler'; import DxSelectBox from 'devextreme-vue/select-box'; import { getTimeZones as getTimeZonesUtility } from 'devextreme/time_zone_utils'; import { DataSource } from 'devextreme-vue/common/data'; import { data, locations } from './data.ts'; const views = ['workWeek']; const dataSource = data; const currentDate = new Date(2021, 3, 27); const getTimeZones = (date: Date) => getTimeZonesUtility(date, locations) const timeZones = ref(getTimeZones(currentDate)); const currentTimeZone = ref(timeZones.value[0].id); function onAppointmentFormOpening(args: DxSchedulerTypes.AppointmentFormOpeningEvent) { const { form } = args; const startDateTimezoneEditor = form.getEditor('startDateTimeZone'); const endDateTimezoneEditor = form.getEditor('endDateTimeZone'); const startDateDataSource = startDateTimezoneEditor?.option('dataSource') as DataSource; const endDateDataSource = endDateTimezoneEditor?.option('dataSource') as DataSource; startDateDataSource.filter(['id', 'contains', 'Europe']); endDateDataSource.filter(['id', 'contains', 'Europe']); startDateDataSource.load(); endDateDataSource.load(); } function onOptionChanged(args: DxSchedulerTypes.OptionChangedEvent) { if (args.name === 'currentDate') { timeZones.value = getTimeZones(args.value); } } </script> <style scoped> .option { display: flex; } .option > span { display: flex; align-items: center; margin-right: 10px; } .dx-scheduler { margin-top: 20px; } </style>

export 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', }, ]; export const locations = ['Europe/London', 'Europe/Berlin', 'Europe/Helsinki'];

import { createApp } from 'vue'; import App from './App.vue'; createApp(App).mount('#app');

<!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/25.1.6/css/dx.light.css" /> <script src="https://cdn.jsdelivr.net/npm/typescript@5.4.5/lib/typescript.js"></script> <script type="module"> import * as vueCompilerSFC from "https://cdn.jsdelivr.net/npm/@vue/compiler-sfc@3.4.27/dist/compiler-sfc.esm-browser.js"; window.vueCompilerSFC = vueCompilerSFC; </script> <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.ts"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"> </div> </div> </body> </html>

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 Scheduler supports different time zones for appointment start and end dates (startDateTimeZone and endDateTimeZone appointment properties).