Date Parsing

Kendo UI exposes methods which convert a specified string to a Date object by using the culture-specific settings.

Settings

Parse without Specifying Format

The kendo.parseDate(string) method converts a string to a JavaScript Date object taking into account the culture's set of default formats.

Example
//current culture is "en-US"
kendo.parseDate("12/22/2000"); //Fri Dec 22 2000

Parse UTC Date Strings

Without Format

When parsing UTC date strings without providing a format string, the resulting JavaScript Date object will render the time according to the local time zone of the user.

Example
kendo.parseDate("2016-02-14T06:15:44.123Z"); // Sun Feb 14 2016 08:15:44 GMT+0200 (FLE Standard Time)

With Format

When you use formats for parsing UTC date strings, apply the zzz specifier to render the local time. Otherwise, the current browser timezone offset will apply.

Example
kendo.parseDate("2016-08-09T05:28:46Z", "yyyy-MM-ddTHH:mm:sszzz") // Tue Aug 09 2016 08:28:46 GMT+0300 (FLE Daylight Time)

Parse by Specifying Format

The kendo.parseDate(string, format) method converts a string to a JavaScript Date object taking into account the specified formats.

Example
kendo.parseDate("2000/12/22", "yyyy/MM/dd");
kendo.parseDate("2000/12/22", ["MM/dd/yyyy", "yyyy/MM/dd"]);

Parse by Specifying Format and Culture Name

The kendo.parseDate(string, format, cultureName) method converts a string to a JavaScript Date object taking into account the specified formats and culture.

Example
kendo.parseDate("2012.07.16", "yyyy/MM/dd", "de-DE");
kendo.parseDate("2012.07.16", ["MM/dd/yyyy", "yyyy/MM/dd"], "de-DE");

Important

  • The kendo.parseDate() parses strings by incrementally matching an increasing portion of the date string, until it satisfies the current corresponding format part. This may lead to unexpected results when parsing ambiguous date strings with no delimiters. For example, the parsing of 222015 with a dMyyyy format fails, because "22" is matched as d and there is no suitable string part left for the month.
  • In addition, parsing is permissive and ignores invalid strings which occur after the year.

Parse by Matching Format Exactly

The kendo.parseExactDate(string, formats) method will parse a string as a Date. If the string does not match the format exactly the method will return null.

Example
kendo.parseExactDate("3/4/2013", "MM/dd/yyyy") // outputs "Mon Mar 04 2013 00:00:00"
kendo.parseExactDate("3/4/2013", "MM/dd/yy") // outputs "null"

See Also

Articles on globalization in Kendo UI:

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