Formatting

The RadScheduler control provides a built-in date formatting support. Each Scheduler ViewDefinition can be easily customized to display dates and times on the time ruler and in the GroupHeaders in custom formats.

Formatting properties

• TimerulerMajorTickStringFormat/TimerulerMinorTickStringFormat: Used to set the format that will be applied on TimeRuler MajorTick/MinorTick;

• TimerulerGroupStringFormat: Sets the format applied on TimeRulerGroupItem;

• GroupHeaderDateStringFormat: Sets the format applied on the Date GroupHeaders.

In this article custom dates and time format strings will be used for setting the various RadScheduler's properties. For more information about the custom date and time format specifiers and the result string produced by each format specifier, check out the Custom Date and Time Format Strings topic.

You will notice that some of the format strings start with {} and some don't. The two curly brackets are required when declaring a format string in XAML that starts with a opening curly bracket, in order to prevent the XAML parser from recognizing it as a markup extension. If the format string starts with a different character, the {} are not needed.

DayViewDefinition

Let’s for example set the formatting properties of DayViewDefinition:

Example 1

<telerik:RadScheduler  AppointmentsSource="{Binding Appointments}"> 
    <telerik:RadScheduler.ViewDefinitions> 
        <telerik:DayViewDefinition 
            TimerulerMajorTickStringFormat="{}{0:%H}:{0:%m} " 
            TimerulerMinorTickStringFormat=":{0:mm} " 
            GroupHeaderDateStringFormat="{}{0:dddd(MM/dd/yy)}" /> 
        ...   
    </telerik:RadScheduler.ViewDefinitions> 
</telerik:RadScheduler> 

WeekViewDefinition

Setting these properties to WeekViewDefinition will lead to similar result:

Example 2

<telerik:RadScheduler  AppointmentsSource="{Binding Appointments}"> 
    <telerik:RadScheduler.ViewDefinitions> 
        ... 
        <telerik:WeekViewDefinition 
            TimerulerMajorTickStringFormat="{}{0:h tt}:{0:mm} " 
            TimerulerMinorTickStringFormat=":{0:mm}" 
            GroupHeaderDateStringFormat="{}{0:dddd(MM/dd)}"  />               
        ...   
    </telerik:RadScheduler.ViewDefinitions> 
 </telerik:RadScheduler> 

MonthViewDefinition

In MonthViewDefinition you can set the following formatting properties:

Example 3

<telerik:RadScheduler  AppointmentsSource="{Binding Appointments}"> 
    <telerik:RadScheduler.ViewDefinitions> 
        ...                      
        <telerik:MonthViewDefinition 
            TimerulerGroupStringFormat="&lt; {0:dddd} &gt;" 
            TimerulerMajorTickStringFormat="{}{0:%M}.{0:%d}"              
            GroupHeaderDateStringFormat="{}{0:MM/dd}"/> 
        ... 
    </telerik:RadScheduler.ViewDefinitions> 
</telerik:RadScheduler> 

And the result is:

TimelineViewDefinition

Setting the formatting properties in TimelineViewDefinition like this:

Example 4

<telerik:RadScheduler  AppointmentsSource="{Binding Appointments}"> 
    <telerik:RadScheduler.ViewDefinitions> 
        ...        
        <telerik:TimelineViewDefinition 
            TimerulerGroupStringFormat="{}{0:yyyy/MM/dd}" 
            TimerulerMajorTickStringFormat="{}{0:%H}" 
            TimerulerMinorTickStringFormat=":{0:%m}" 
            MajorTickLength="1h" 
            MinorTickLength="10min" 
            MinTimeRulerExtent="30400" 
            MaxTimeRulerExtent="30400" /> 
         ... 
        </telerik:RadScheduler.ViewDefinitions> 
</telerik:RadScheduler>