TimeZone Editor - Overview

The Time Zone editor enables the end-user to specify a time zone used in a client scheduler. By default, the SchedulerOptionsBehaviorBase.ClientTimeZoneId property value is used to set the time zone for the scheduler and for its time ruler.

To learn more about the Time Zone editor and see it in action, refer to the Time Zones online demo.

Implementation Details

The Time Zone editor is represented by the TimeZoneEditExtension class. Its instance can be accessed via the ExtensionsFactory.TimeZoneEdit helper method, which is used to add a Time Zone editor extension to a view. This method's parameter provides access to the editor settings implemented by the TimeZoneEditSettings class, allowing you to fully customize the extension.

Declaration

Since the Time Zone editor requires a SchedulerControl for proper operation, the TimeZoneEditSettings.SchedulerName property should be set to the SettingsBase.Name of a Scheduler control. Add the Time Zone editor to a view in the following manner.

View (Razor syntax):

@Html.DevExpress().TimeZoneEdit(
    settings => {
        settings.Name = "timeZoneEdit";
        settings.SchedulerName = "scheduler";
        settings.Width = Unit.Percentage(50);
    }).GetHtml()

The Time Zone editor is shown in the picture below.

Scheduler_TimeZoneEdit

See Also