DateTimeLabelFormatCollection Class
The collection of DateTimeLabelFormat objects.
Namespace: DevExpress.Maui.Charts
Assembly: DevExpress.Maui.Charts.dll
NuGet Package: DevExpress.Maui.Charts
#Declaration
public class DateTimeLabelFormatCollection :
ObservableCollection<DateTimeLabelFormat>
#Related API Members
The following members return DateTimeLabelFormatCollection objects:
#Remarks
The ChartView can detect if adjacent date-time argument values belong to different time intervals (for example, days of different months) and automatically display a transition label on a date-time axis (for example, the first-day label of the next month) with a different format.
To enable this functionality, assign an AxisLabelFormatAutoReplaceOptions object to the DateTimeAxisX.LabelFormatAutoReplaceOptions property and use the AxisLabelFormatAutoReplaceOptions.LabelFormats property to access and manage the collection of label formats for date-time arguments of different measurement units. An individual item of this collection is a DateTimeLabelFormat object.
Note
Label
If you do not populate the LabelFormats collection explicitly, the following default formats are used depending on the axis’s MeasureUnit and GridAlignment settings:
Measurement Unit* | Label Format |
---|---|
Millisecond | Millisecond - “SSS” |
Second | Second - “HH:mm:ss” |
Day | Day - “dd MMMM” |
Month | Month - “MMMM” |
Year | Year - “yyyy” |
Measurement Unit* - the larger measurement unit assigned to the MeasureUnit and GridAlignment properties.
#Example
The following example configures a date-time axis so that it automatically shows when the next month starts:
<dxc:DateTimeAxisX x:Name="xAxis" GridAlignment="Day" GridSpacing="5">
<dxc:DateTimeAxisX.LabelFormatAutoReplaceOptions>
<dxc:AxisLabelFormatAutoReplaceOptions>
<dxc:DateTimeLabelFormat MeasureUnit="Day" Format="d"/>
<dxc:DateTimeLabelFormat MeasureUnit="Month" Format="MMM, d"/>
</dxc:AxisLabelFormatAutoReplaceOptions>
</dxc:DateTimeAxisX.LabelFormatAutoReplaceOptions>
</dxc:DateTimeAxisX>