W3cubDocs

/JavaScript

date.toDateString

The toDateString() method returns the date portion of a Date object in human readable form in American English.

Syntax

dateObj.toDateString()

Return value

A string representing the date portion of the given Date object in human readable form in American English.

Description

Date instances refer to a specific point in time. Calling toString() will return the date formatted in a human readable form in American English. In SpiderMonkey, this consists of the date portion (day, month, and year) followed by the time portion (hours, minutes, seconds, and time zone). Sometimes it is desirable to obtain a string of the time portion; such a thing can be accomplished with the toTimeString() method.

The toDateString() method is especially useful because compliant engines implementing ECMA-262 may differ in the string obtained from toString() for Date objects, as the format is implementation-dependent and simple string slicing approaches may not produce consistent results across multiple engines.

Examples

A basic usage of toDateString()

var d = new Date(1993, 5, 28, 14, 39, 7);

console.log(d.toString());     // logs Wed Jun 28 1993 14:39:07 GMT-0600 (PDT)
console.log(d.toDateString()); // logs Wed Jun 28 1993

Note: Month are 0-indexed when used as an argument of Date (thus 0 corresponds to January and 11 to December).

Specifications

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support Yes Yes 1 Yes Yes Yes
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes Yes Yes 4 Yes Yes Yes
Server
Node.js
Basic support Yes

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toDateString