Formatting Date-Time Values

  • 3 minutes to read

The Date Occurring conditional format allows you to highlight date-time values that fall into a specified interval.

The image below shows the grid column whose Order Date cells are yellow if their values belong to the last month interval.

CFDateOccurringExample

Refer to the Formatting Values Using Comparison Rules topic to learn how to format cells comparing cell values with static values. The Formatting Values Using Custom Conditions topic describes how to use custom conditions.

This topic contains the following sections.

Adding Rules in Code

Create the FormatCondition class instance and specify the following settings to create a conditional format in code:

The following code sample illustrates how to define a conditional format in markup:

<dxg:TableView.FormatConditions>
   <dxg:FormatCondition Expression="DateDiffMonth([Order Date], LocalDateTimeToday()) = 1" FieldName="Order Date" PredefinedFormatName="YellowFillWithDarkYellowText" />
</dxg:TableView.FormatConditions>

The code sample below illustrates how to define the same conditional format in code-behind:

var orderDateFormatCondition = new FormatCondition() {
   Expression = "DateDiffMonth([Order Date], LocalDateTimeToday()) = 1",
   FieldName = "Order Date",
   PredefinedFormatName = "YellowFillWithDarkYellowText"
};
view.FormatConditions.Add(orderDateFormatCondition);

Adding Rules Using Conditional Formatting Menu

  1. Select the Highlight Cells Rules item in the Conditional Formatting Menu, and choose the A Date Occurring conditional format in the invoked sub menu.
  2. In the invoked dialog, specify a date-time interval whose values should be formatted.
  3. Choose a format to define the applied rule's visual appearance. The conditional formatting menu allows you to use only predefined formats stored within the TableView.PredefinedFormats (or TreeListView.PredefinedFormats) collection.
  4. Enable the apply format to the entire row option to apply a conditional format to the entire row, if necessary.

CFDataOccurringMenu

Adding Rules Using Conditional Formatting Rules Manager

  1. Click the New Rule... in the Conditional Formatting Rules Manager.
  2. Select the Format only cells that contain rule type in the invoked New Formatting Rule dialog.
  3. Select the Data Occurring conditional format and choose a date-time interval whose values should be formatted.
  4. To define the visual appearance of the applied rule, click the Format button, and specify the required settings in the invoked Format Cells dialog. See the Format Cells Dialog Window section of the Conditional Formatting Rules Manager topic to learn more.

CFDateOccurringManager

See Also