New to Telerik UI for WinForms? Download free 30-day trial

Updating the Header Text of RadScheduler in Month View


Product Version Author
RadScheduler for WinForms 2024.2.514 Nadya Todorova


An example demonstrating how the header text that shows the start/end week date of the RadScheduler can be updated to show the dates in different format when the control is setup in Month View.


To change the format of the header cells that are shown in the MonthViewVerticalHeader you can use the ElementInvalidated event. Please refer to the following code snippet that demonstrates how you can change the date format to "dd.MM.yyyy".

Figure 1: Custom Header Text


Updating Header in MonthViewVerticalHeader

public RadForm1()
    this.radScheduler1.ActiveViewType = Telerik.WinControls.UI.SchedulerViewType.Month;
    this.radScheduler1.ElementInvalidated += RadScheduler1_ElementInvalidated;

private void RadScheduler1_ElementInvalidated(object sender, EventArgs e)
    SchedulerHeaderCellElement cell = sender as SchedulerHeaderCellElement;
    string firstDayFormat = "dd.MM.yyyy";
    string lastDayFormat = "dd.MM.yyyy";
    SchedulerMonthView MonthView = this.radScheduler1.GetMonthView();
    if (MonthView != null)
        DateTime dateToRender = MonthView.StartDate;
        int days = 6;

        if (MonthView.ShowWeekend)
            days = 4;

        if (cell != null && cell.Parent is MonthViewVerticalHeader)
            cell.Text = String.Format(this.radScheduler1.DateTimeFormat, "{0} - {1}",
                dateToRender.ToString(firstDayFormat, this.radScheduler1.DateTimeFormat),
                dateToRender.AddDays(days).ToString(lastDayFormat, this.radScheduler1.DateTimeFormat));

            dateToRender = this.radScheduler1.DateTimeFormat.Calendar.AddWeeks(dateToRender, 1);

    Public Sub New()
        Me.radScheduler1.ActiveViewType = Telerik.WinControls.UI.SchedulerViewType.Month
        AddHandler Me.radScheduler1.ElementInvalidated, AddressOf RadScheduler1_ElementInvalidated
    End Sub

    Private Sub RadScheduler1_ElementInvalidated(ByVal sender As Object, ByVal e As EventArgs)
        Dim cell As SchedulerHeaderCellElement = TryCast(sender, SchedulerHeaderCellElement)
        Dim firstDayFormat As String = "dd.MM.yyyy"
        Dim lastDayFormat As String = "dd.MM.yyyy"
        Dim MonthView As SchedulerMonthView = Me.radScheduler1.GetMonthView()

        If MonthView IsNot Nothing Then
            Dim dateToRender As DateTime = MonthView.StartDate
            Dim days As Integer = 6

            If MonthView.ShowWeekend Then
                days = 4
            End If

            If cell IsNot Nothing AndAlso TypeOf cell.Parent Is MonthViewVerticalHeader Then
                cell.Text = String.Format(Me.radScheduler1.DateTimeFormat, "{0} - {1}", dateToRender.ToString(firstDayFormat, Me.radScheduler1.DateTimeFormat), dateToRender.AddDays(days).ToString(lastDayFormat, Me.radScheduler1.DateTimeFormat))
                dateToRender = Me.radScheduler1.DateTimeFormat.Calendar.AddWeeks(dateToRender, 1)
            End If
        End If
    End Sub

See Also

In this article