DateTimeScaleOptions.WorkTimeRules Property

Returns a collection of work time rules which should be applied to the date-time axis scale.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.1.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[PersistenceMode(PersistenceMode.InnerProperty)]
[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
[XtraSerializableProperty(XtraSerializationVisibility.Collection, true)]
public WorkTimeRuleCollection WorkTimeRules { get; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
<PersistenceMode(PersistenceMode.InnerProperty)>
<XtraSerializableProperty(XtraSerializationVisibility.Collection, True)>
Public ReadOnly Property WorkTimeRules As WorkTimeRuleCollection

Property Value

Type	Description
WorkTimeRuleCollection	A collection of WorkTimeRule objects.

Property Paths

You can access this nested property as listed below:

Object Type	Path to WorkTimeRules
AxisBase	.DateTimeScaleOptions .WorkTimeRules

Example

The following code demonstrates how to configure work time rules.

C#

XYDiagram chartDiagram = (XYDiagram)financialChart.Diagram;
DateTimeScaleOptions xAxisScaleOptions = chartDiagram.AxisX.DateTimeScaleOptions;

// This property turns on axis values filtering by rules.
xAxisScaleOptions.WorkTimeOnly = true;

// Create a new instance of the worktime rule which will be used to specify
// the worktime displayed on the X-axis.
WorkTimeRule weekdayRule = new WorkTimeRule();
xAxisScaleOptions.WorkTimeRules.Add(weekdayRule);
// Specify one or more work intervals of this rule.
weekdayRule.WorkIntervals.Add(new TimeInterval(09, 00, 00, 19, 00, 00));
// Add weekdays on which this rule should be applied.
weekdayRule.Weekdays = Weekday.Monday | Weekday.Tuesday | Weekday.Wednesday 
        | Weekday.Thursday | Weekday.Friday;

WorkTimeRule dateRule = new WorkTimeRule();
xAxisScaleOptions.WorkTimeRules.Add(dateRule);
dateRule.WorkIntervals.Add(new TimeInterval(12, 00, 00, 16, 00, 00));
// Besides Weekdays, you can specify the Date 
// on which this rule should be applied.
dateRule.Date = new DateTime(2017, 1, 1);

VB.NET

Dim chartDiagram As XYDiagram = DirectCast(financialChart.Diagram, XYDiagram)
Dim xAxisScaleOptions As DateTimeScaleOptions = chartDiagram.AxisX.DateTimeScaleOptions

' This property turns on axis values filtering by rules.
xAxisScaleOptions.WorkTimeOnly = True

' Create a new instance of the worktime rule which will be used to specify 
' the worktime displayed on the X-axis.
Dim weekdayRule As New WorkTimeRule()
xAxisScaleOptions.WorkTimeRules.Add(weekdayRule)
' Specify one or more work intervals of this rule.
weekdayRule.WorkIntervals.Add(New TimeInterval(09, 00, 00, 19, 00, 00))
' Add weekdays on which this rule should be applied.
weekdayRule.Weekdays = Weekday.Monday Or Weekday.Tuesday Or Weekday.Wednesday _
        Or Weekday.Thursday Or Weekday.Friday

Dim dateRule As New WorkTimeRule()
xAxisScaleOptions.WorkTimeRules.Add(dateRule)
dateRule.WorkIntervals.Add(New TimeInterval(12, 00, 00, 16, 00, 00))
' Besides Weekdays, you can specify the Date 
' on which this rule should be applied.
dateRule.Date = New DateTime(2017, 1, 1)