--- title: Date.prototype.toString() slug: Web/JavaScript/Reference/Global_Objects/Date/toString tags: - Date - JavaScript - Довідка - метод translation_of: Web/JavaScript/Reference/Global_Objects/Date/toString ---
{{JSRef}}

Метод toString() повертає рядкове представлення вказаного об'єкта {{jsxref("Date")}}.

{{EmbedInteractiveExample("pages/js/date-tostring.html","shorter")}}

Синтаксис

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 = 'Сьогодні ' + new Date().

toString() є загальним методом, він не вимагає, щоб його this був екземпляром {{jsxref("Date")}}. Однак, він повинен мати внутрішню властивість [[TimeValue]], яку неможливо створити за допомогою вбудованих методів javascript, тому він обмежений використанням з екземплярами {{jsxref("Date")}}. Якщо метод викликається не на екземплярі Date, викидається {{jsxref("TypeError")}}.

Приклади

Використання toString()

Наступний код присвоює значення toString() об'єкта {{jsxref("Date")}} змінній 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")}}

Див. також