Internationalization Overview

The internationalization approaches in Kendo UI for jQuery apply the desired cultures by providing services for defining the desired cultures and parsing and formatting of dates and numbers.

Getting Started

Kendo UI provides a way to internationalize the current page using a culture script. Kendo UI exposes culture (cultureName) method which allows you to select the culture script corresponding to the <language code>-<country/region code>. For more information on the culture method, refer to the API reference article on this method.

All Kendo UI widgets which support date or number formatting depend also on the current culture. These widgets are the more complex ones such as the Grid, ListView, Charts, and so on.

The following Kendo UI widgets depend on the current culture:

Defining the Current Culture

The default culture which Kendo UI widgets use is "en-US".

  • You have to set the culture before the initialization of any Kendo UI widgets which rely on it.
  • If you include the generic culture file, you can omit the country or region code. For example, you can use kendo.culture.en.min.js with kendo.culture("en"); instead of kendo.culture.en-GB.min.js with kendo.culture("en-GB");. However, the generic files do not carry country or region specifics and can only serve as a more generic representation.

To define the current culture:

  1. Add the required culture script to the page, as demonstrated in the example below.

        <script src="jquery.js"></script>
        <script src="kendo.all.min.js"></script>
        <script src="kendo.culture.en-GB.js"></script>
    
        <!-- or when using the Kendo UI CDN -->
        <script src="http://kendo.cdn.telerik.com/<version>/js/jquery.min.js"></script>
        <script src="http://kendo.cdn.telerik.com/<version>/js/kendo.all.min.js"></script>
        <script src="http://kendo.cdn.telerik.com/<version>/js/cultures/kendo.culture.en-GB.min.js"></script>
    
  2. Set the culture script that Kendo UI will use.

        <script type="text/javascript">
            //set current to the "en-GB" culture script
            kendo.culture("en-GB");
        </script>
    

Formatting Date and Number Objects

Kendo UI exposes the following methods which can format the number or date objects by using a specific format string and the current specified culture.

For more information, refer to the article on date formatting.

Parsing Strings

Kendo UI exposes the following methods which convert the specified string to a date or number object.

For more information, refer to the article on date parsing.

See Also

In this article
Not finding the help you need? Improve this article