Kendo 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 and etc.

Kendo provides a way to internationalize the current page using a culture script. Kendo exposes culture(cultureName) method which allows to select the culture script coresponding to the "<language code>-<country/region code>". For complete overview of the culture method, review the Kendo API Reference.

Define the current culture

First let's start by adding the required culture script:

Add culture scripts to the page:

<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 CDN -->
<script src="http://cdn.kendostatic.com/<version>/js/jquery.min.js"></script>
<script src="http://cdn.kendostatic.com/<version>/js/kendo.all.min.js"></script>
<script src="http://cdn.kendostatic.com/<version>/js/cultures/kendo.culture.en-GB.min.js"></script>

Set current culture:

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

Format Number or Date object

Kendo exposes methods which can format number or date object using specific format string and the current specified culture:

• kendo.toString(object, format, [culture]) - returns a string representation of the current object taking into account the given format and culture.
• kendo.format(format, arguments) - replaces each format item in a specified string with the text equivalent of a corresponding object's value.

For more detail information check these helps topics: Number Formatting and Date Formatting

Parsing a string

Kendo exposes methods which converts the specified string to date or number object:

• kendo.parseInt(string, [culture]) - converts a string to a whole number using the specified culture (current culture by default).
• kendo.parseFloat(string, [culture]) - converts a string to a number with floating point using the specified culture (current culture by default).
• kendo.parseDate(string, [formats], [culture]) - converts a string to a JavaScript Date object, taking into account the given format/formats (or the given culture's set of default formats).

For more detail information, check these help topics: Number Parsing and Date Parsing

globalize.js support

Widgets that depend on culture info

Here is a list of widgets which depends on the current culture:

• Calendar
• DatePicker
• TimePicker
• DateTimePicker
• NumericTextBox