Time Zone Support
The Scheduler allows its users to view appointments in different time zones. Set the timeZone property to specify the current time zone. This property accepts values from the IANA time zone database.
In this demo, you can use the drop-down menu above the Scheduler to choose between the London, Berlin, and Helsinki time zones. To populate the menu, the getTimeZones utility method is used. It returns a list of all IANA time zones that is then filtered.
Users can edit the time zones of individual appointments in the appointment details form. To enable this functionality, set the editing.allowTimeZoneEditing property to true. Information about individual time zones is saved in the startDateTimeZone and endDateTimeZone fields of the appointment data objects.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<div class="option">
<span>Office Time Zone</span>
<dx-select-box
[items]="demoLocations"
[width]="240"
[inputAttr]="{ 'aria-label': 'Location' }"
displayExpr="title"
valueExpr="id"
[(value)]="timezone"
>
</dx-select-box>
</div>
<dx-scheduler
[dataSource]="dataSource"
[timeZone]="timezone"
[views]="['workWeek']"
currentView="workWeek"
[currentDate]="currentDate"
[height]="600"
[startDayHour]="8"
(onAppointmentFormOpening)="onAppointmentFormOpening($event)"
(onOptionChanged)="onOptionChanged($event)"
>
<dxo-editing [allowTimeZoneEditing]="true"> </dxo-editing>
</dx-scheduler>
import { NgModule, Component, enableProdMode } from '@angular/core';
import { BrowserModule, BrowserTransferStateModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxSchedulerModule, DxSelectBoxModule, DxTemplateModule } from 'devextreme-angular';
import { getTimeZones, dxSchedulerTimeZone } from 'devextreme/time_zone_utils';
import { Service, Data } from './app.service';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css'],
providers: [Service],
preserveWhitespaces: true,
})
export class AppComponent {
currentDate: Date = new Date(2021, 3, 27);
timezone: string;
locations: string[];
dataSource: Data[];
demoLocations: dxSchedulerTimeZone[];
service: Service;
constructor(service: Service) {
this.service = service;
this.demoLocations = this.getLocations(this.currentDate);
this.dataSource = service.getData();
this.timezone = this.demoLocations[0].id;
this.currentDate = this.currentDate;
}
getLocations(date: Date) {
const timeZones = getTimeZones(date);
return timeZones.filter((timeZone) => this.service.getLocations().indexOf(timeZone.id) !== -1);
}
onValueChanged(e: any) {
this.timezone = e.value;
}
onAppointmentFormOpening(e: any) {
const form = e.form;
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();
}
onOptionChanged(e) {
if (e.name === 'currentDate') {
this.demoLocations = this.getLocations(e.value);
}
}
}
@NgModule({
imports: [
BrowserModule,
BrowserTransferStateModule,
DxSchedulerModule,
DxTemplateModule,
DxSelectBoxModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .option {
display: flex;
}
::ng-deep .option > span {
display: flex;
align-items: center;
margin-right: 10px;
}
::ng-deep .dx-scheduler {
margin-top: 20px;
}
import { Injectable } from '@angular/core';
export class Data {
text: string;
startDate: string;
endDate: string;
recurrenceRule?: string;
}
export class Location {
id: string;
offset: number;
title: string;
}
export const data: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'];
@Injectable()
export class Service {
getLocations() {
return locations;
}
getData() {
return data;
}
}
// In real applications, you should not transpile code in the browser.
// You can see how to create your own application with Angular and DevExtreme here:
// https://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/
window.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
},
meta: {
'typescript': {
'exports': 'ts',
},
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
map: {
'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'@angular/core': 'npm:@angular/core@12.2.17',
'@angular/platform-browser': 'npm:@angular/platform-browser@12.2.17',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.17',
'@angular/forms': 'npm:@angular/forms@12.2.17',
'@angular/common': 'npm:@angular/common@12.2.17',
'@angular/compiler': 'npm:@angular/compiler@12.2.17',
'tslib': 'npm:tslib@2.3.1/tslib.js',
'rxjs': 'npm:rxjs@7.5.3/dist/bundles/rxjs.umd.js',
'rxjs/operators': 'npm:rxjs@7.5.3/dist/cjs/operators/index.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@23.1.5/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@23.1.5/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.2/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.1',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.48',
'devextreme-angular': 'npm:devextreme-angular@23.1.5',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.11',
'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts',
},
'devextreme': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
'rxjs': {
defaultExtension: 'js',
},
'rxjs/operators': {
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.11/inferno/package.json',
'npm:@angular/*/package.json',
'npm:@angular/common@12.2.17/*/package.json',
'npm:rxjs@7.5.3/package.json',
'npm:rxjs@7.5.3/operators/package.json',
'npm:devextreme-angular@23.1.5/*/package.json',
'npm:devextreme-angular@23.1.5/ui/*/package.json',
'npm:devextreme-angular@23.1.5/package.json',
'npm:devexpress-diagram@2.2.1/package.json',
'npm:devexpress-gantt@4.1.48/package.json',
],
};
System.config(window.config);
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<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=1.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.1.5/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.12.0/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.13/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="config.js"></script>
<script>
System.import("app").catch(console.error.bind(console));
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<demo-app>Loading...</demo-app>
</div>
</body>
</html>