Edit this page

Globalization Overview

Globalization is the process of designing and developing an application that works in multiple cultures. The culture defines specific information for the number formats, week and month names, date and time formats, etc.

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 detailed information on the culture method, refer to the API reference article on this method.

Define Current Culture

First, add the required culture script to the page, as demonstrated in the example below.

Example
<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>

Now, set the culture script, which Kendo UI should use, as shown below.

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

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

The culture must be set before any Kendo UI widgets that rely on it, are initialized.

Configuration

Format Number or Date Objects

Kendo UI exposes methods, which can format the number or date objects using a specific format string and the current specified culture. These are:

For detailed information, refer to this article.

Parse Strings

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

For detailed information, refer to this article.

Support

(Deprecated) jQuery GlobalizeJS 0.1

If you load GlobalizeJS, the default globalization features in Kendo UI are overridden. Some features might not work. For example, custom number formats are unsupported in this case.

Important

The Globalization 0.1 library is no longer supported. It is advisable not to use it. For more details, refer to the #1354 issue.

Widgets Depending on Culture Information

Here is a list of Kendo UI widgets which depend on the current culture:

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

See Also

Articles on globalization in Kendo UI: