The CultureInfo class represents information about a specific culture including the names of the culture, the writing system, and the calendar used, as well as access to culture-specific objects that provide information for common operations, such as formatting dates and sorting strings.

The culture names follow the RFC 1766 standard in the format "<languagecode2>-<country/regioncode2>", where <languagecode2> is a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> is an uppercase two-letter code derived from ISO 3166. For example, U.S. English is "en-US".

All RadCalendar controls let you associate a CultureInfo object with the control to govern the formatting and parsing of date and time values. The following table lists the property to use for assigning a CultureInfo object to each RadCalendar control:

Note
On RadDatePicker, RadTimePicker, and RadDateTimePicker, you can assign a separate CultureInfo object to the embedded popup calendar and/or time view control, using the embedded calendar's CultureInfo property or the embedded time view's Culture property.

The associated CultureInfo object controls

• The default format for the date and time values that the control displays. You can override this pattern by specifying a date format pattern as the value of the following properties:
  • On RadCalendar (including the embedded popup calendar accessed through the Calendar property of a RadDatePicker or RadDateTimePicker control), the TitleFormat and DayCellToolTipFormat properties.
  • On RadDatePicker, RadTimePicker, and RadDateTimePicker, the DateFormat and DisplayDateFormat properties of the embedded RadDateInput control (accessed through the DateInput property).
  • On RadTimePicker and RadDateTimePicker, the TimeFormat property of the embedded RadTimeView control (accessed through the
• The strings used when applying a date format pattern, such as month names, day names, separator characters, and so on.
• The first day of the week when the FirstDayOfWeek property is set to "Default".
• The way RadDatePicker, RadTimePicker, and RadDateTimePicker parse values that the user types into the input area.

Caution
The CultureInfo property of RadCalendar does not affect the labels on the buttons in the month/year navigation popup. For information on localizing these strings, see Localizing Strings.

You can assign the culture of a RadCalendar control declaratively in the source:

CopyASPX

<telerik:RadCalendar
    ID="RadCalendar1"
    runat="server"
    CultureInfo="French (France)">
</telerik:RadCalendar>
<br />
<telerik:RadDatePicker
    ID="RadDatePicker1"
    runat="server"
    Culture="French (France)">
    <DateInput Width="100%"></DateInput>
    <DatePopupButton CssClass="radPopupImage_Default" />
</telerik:RadDatePicker>
<br />
<telerik:RadDateTimePicker
    ID="RadDateTimePicker1"
    runat="server"
    Culture="French (France)">
    <DateInput Width="100%"></DateInput>
    <DatePopupButton CssClass="radPopupImage_Default" />
    <TimePopupButton CssClass="radPopupImage_Default" />
</telerik:RadDateTimePicker>
<br />
<telerik:RadTimePicker
    ID="RadTimePicker1"
    runat="server"
    Culture="French (France)">
</telerik:RadTimePicker>

You can assign a culture property in the code-behind as well:

• C#
• VB.NET

CopyC#

protected void Page_Load(object sender, EventArgs e)
{
    RadCalendar1.CultureInfo = System.Threading.Thread.CurrentThread.CurrentCulture;
    RadDatePicker.Culture = new System.Globalization.CultureInfo("en-US", true);
    RadTimePicker.Culture = new System.Globalization.CultureInfo("fr-FR", true);
    RadDateTimePicker.Culture = RadDateTimePicker.Culture;
}

CopyVB.NET

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
    RadCalendar1.CultureInfo = System.Threading.Thread.CurrentThread.CurrentCulture
    RadDatePicker.Culture = New System.Globalization.CultureInfo("en-US", True)
    RadTimePicker.Culture = New System.Globalization.CultureInfo("fr-FR", True)
    RadDateTimePicker.Culture = RadDateTimePicker.Culture
End Sub

Other Resources