Date.prototype.toDateString()
The toDateString()
method returns the date portion of a
Date
object in English in the following format separated by spaces:
- First three letters of the week day name
- First three letters of the month name
- Two digit day of the month, padded on the left a zero if necessary
- Four digit year (at least), padded on the left with zeros if necessary
E.g. "Thu Jan 01 1970".
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
dateObj.toDateString()
Return value
A string representing the date portion of the given Date
object in human
readable form in English.
Description
Date
instances refer to a specific point in time. Calling
toString()
will return the date formatted in
a human readable form in 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 Mon Jun 28 1993 14:39:07 GMT-0600 (PDT)
console.log(d.toDateString()); // logs Mon 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
Specification |
---|
ECMAScript (ECMA-262) The definition of 'Date.prototype.toDateString' in that specification. |
Browser compatibility
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.