Globalization / Internationalization

New to Kendo UI for jQuery? Download free 30-day trial

Date Formatting

The purpose of date formatting is to convert the Date object to a human readable string by using the culture-specific settings.

The kendo.format and kendo.toString methods support standard and custom date formats.

The following runnable example demonstrates how to convert a JavaScript Date object to a string by using the kendo.toString method:

    <!-- Add the de-DE culture file -->
    <script src="https://kendo.cdn.telerik.com/2022.1.119/js/cultures/kendo.culture.de-DE.min.js"></script>
    <h4>Date formats with US culture.</h4>
    <div id="content"></div>
    <h4>Date formats with DE culture.</h4>
    <div id="content2"></div>
    <h4>Applying Date formatting to Grid columns.</h4>
    <div id="grid"></div>
    <script>
      // Default culture is en-US.
      let format = "<p> Format 'd' = " + kendo.toString(new Date(), "d") + "</p>"
      +"<p> Format 'D' = " + kendo.toString(new Date(), "D") + "</p>"
      +"<p> Format 'F' = " + kendo.toString(new Date(), "F") + "</p>"
      +"<p> Format 'g' = " + kendo.toString(new Date(), "g") + "</p>"
      +"<p> Format 'u' = " + kendo.toString(new Date(), "u") + "</p>"
      +"<p> Custom format dd/MMMM/yyyy H:mm = " + kendo.toString(new Date(), "dd/MMMM/yyyy H:mm") + "</p><hr>";
      $(format).appendTo(content);

      // Switch to DE culture.
      kendo.culture("de-DE");

      let format2 = "<p> Format 'd' = " + kendo.toString(new Date(), "d") + "</p>"
      +"<p> Format 'D' = " + kendo.toString(new Date(), "D") + "</p>"
      +"<p> Format 'F' = " + kendo.toString(new Date(), "F") + "</p>"
      +"<p> Format 'g' = " + kendo.toString(new Date(), "g") + "</p>"
      +"<p> Format 'u' = " + kendo.toString(new Date(), "u") + "</p>"
      +"<p> Custom format dd/MMMM/yyyy H:mm = " + kendo.toString(new Date(), "dd/MMMM/yyyy H:mm") + "</p><hr>";

      $(format2).appendTo(content2);

      $("#grid").kendoGrid({
        dataSource: [{dateField: new Date(), dateField1: new Date(), dateField2: new Date(), dateField3: new Date(), dateField4: new Date(), dateField5: new Date()}],
        columns: [{
          field: "dateField",
          format: "{0:d}"
        },{
          field: "dateField1",
          format: "{0:D}"
        },{
          field: "dateField2",
          format: "{0:F}"
        },{
          field: "dateField3",
          format: "{0:g}"
        },{
          field: "dateField4",
          format: "{0:u}"
        },{
          field: "dateField5",
          format: "{0:dd/MMMM/yyyy H:mm}"
        }]
      });
    </script>

Default Date Formats

The following table lists the default Kendo UI date format specifiers.

Specifier Result
standard Retrieved from the used Kendo UI culture script that is defined with the kendo.culture method.
d Renders a short date pattern ("M/d/yyyy" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "d") -> 10/6/2000.
D Renders a long date pattern ("dddd, MMMM dd, yyyy" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "D") -> Monday, November 06, 2000.
F Renders a full date/time pattern ("dddd, MMMM dd, yyyy h:mm:ss tt" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "F") -> Monday, November 06, 2000 12:00:00 AM.
g Renders a general date/time pattern (short time) ("M/d/yyyy h:mm tt" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "g") -> 11/6/2000 12:00 AM.
G Renders a general date/time pattern (long time) ("M/d/yyyy h:mm:ss tt" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "G") -> 11/6/2000 12:00:00 AM.
M or m Render a month/day pattern ("MMMM dd" for en-US). For example, `kendo.toString(new Date(2000, 10, 6), "m") -> November 06.
t Renders a short time pattern ("h:mm tt" for en-US). For example, kendo.toString(new Date(2000, 10, 6, 14, 30, 45), "t") -> 2:30 PM.
T Renders a long time pattern ("h:mm:ss tt" for en-US). For example, kendo.toString(new Date(2000, 10, 6, 14, 30, 45), "T") -> 2:30:45 PM.
s Renders universal sortable local date/time pattern ("yyyy-MM-dd HH:mm:ss" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "s") -> 2000-11-06 00:00:00.
u Renders universal sortable UTC date/time pattern ("yyyy-MM-dd HH:mm:ssZ" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "u") -> 2000-11-06 00:00:00Z.
Y or y Renders a year/month pattern ("MMMM, yyyy" for en-US). For example, kendo.toString(new Date(2000, 10, 6), "y") -> November, 2000.

Custom Date Formats

The following table lists the supported custom date format specifiers.

Specifier Result
"d" Renders the day of the month, from 1 through 31.
"dd" The day of the month, from 01 through 31.
"ddd" The abbreviated name of the day of the week.
"dddd" The full name of the day of the week.
"f" The tenths of a second in a date and time value.
"ff" The hundredths of a second in a date and time value.
"fff" The milliseconds in a date and time value.
"M" The month, from 1 through 12.
"MM" The month, from 01 through 12.
"MMM" The abbreviated name of the month.
"MMMM" The full name of the month.
"h" The hour, using a 12-hour clock from 1 to 12.
"hh" The hour, using a 12-hour clock from 01 to 12.
"H" The hour, using a 24-hour clock from 1 to 23.
"HH" The hour, using a 24-hour clock from 01 to 23.
"m" The minute, from 0 through 59.
"mm" The minute, from 00 through 59.
"s" The second, from 0 through 59.
"ss" The second, from 00 through 59.
"tt" The AM/PM designator.
"yy" The last two characters from the year value.
"yyyy" The year full value.
"zzz" The local timezone when using formats to parse UTC date strings.

See Also

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