--- title: Date.prototype.toString() slug: Web/JavaScript/Reference/Global_Objects/Date/toString tags: - Date - JavaScript - Method - Prototype - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Date/toString ---
toString()
メソッドは、指定した {{jsxref("Date")}} オブジェクトを表す文字列を返します。
dateObj.toString()
与えられた日付を表す文字列。
{{jsxref("Date")}} のインスタンスは toString()
メソッドを {{jsxref("Date.prototype")}} から継承しており、 {{jsxref("Object.prototype")}} から継承しているわけではありません。 Date.prototype.toString()
は Date を表す文字列を、 ECMA-262 で指定された以下のような書式で返します。
例 "Sat Sep 01 2018 14:53:26 GMT+1400 (LINT)"
ECMAScript 2018 (第9編) まで、 Date.prototype.toString
が返す文字列の書式は実装に依存していました。したがって、指定された書式通りであることに頼ってはいけません。
toString()
メソッドは、日付がテキスト値で表現されるとき、例えば console.log(new Date())
、または日付が文字列に強制変換されるとき、例えば var today = 'Today is ' + new Date()
などで自動的に呼び出されます。
toString()
は汎用メソッドです。 this
が {{jsxref("Date")}} インスタンスある必要はありません。しかし、ネイティブの JavaScript を使用して構築することができない内部の [[TimeValue]]
プロパティを持っている必要があるため、事実上は {{jsxref("Date")}} インスタンスでの使用に限定されています。日付でないインスタンスで呼び出された場合、 {{jsxref("TypeError")}} が発生します。
次の例は、{{jsxref("Date")}} オブジェクトの toString()
値を myVar
に代入します。
var x = new Date(); var myVar = x.toString(); // 次のような値を myVar に代入します: // Mon Sep 08 1998 14:36:22 GMT-0700 (PDT)
仕様書 |
---|
{{SpecName('ESDraft', '#sec-date.prototype.tostring', 'Date.prototype.toString')}} |
{{Compat("javascript.builtins.Date.toString")}}