Date.prototype.toString()
Метод toString()
повертає рядкове представлення вказаного об'єкта Date
.
Синтаксис
dateObj.toString()
Повертає
Рядкове представлення наданої дати.
Опис
Екземпляри Date
успадковують метод toString()
від Date.prototype
, а не від Object.prototype
. Date.prototype.toString()
повертає рядкове представлення об'єкта Date у форматі, вказаному у ECMA-262, який можна підсумувати наступним чином:
- День тижня: 3 літери англійської назви дня тижня, наприклад, "Sat"
- пробіл
- Місяць: 3 літери англійської назви місяця, наприклад, "Sep"
- пробіл
- День: 2-значний день місяця, наприклад, "01"
- пробіл
- Рік: 4-значний рік, наприклад, "2018"
- пробіл
- Година: 2-значна година, наприклад, "14"
- двокрапка
- Хвилини: 2-значні хвилини, наприклад, "53"
- двокрапка
- Секунди: 2-значні секунди, наприклад, "26"
- пробіл
- Рядок "GMT"
- Знак зсуву часового поясу, один з:
- "+" для додатного зсуву (0 чи більше)
- "-" для від'ємного зсуву (менше нуля)
- Двозначний зсув годин, наприклад, "14"
- Двозначний зсув хвилин, наприклад, "00"
- Необов'язково, ім'я часового поясу, що складається з:
- пробілу
- Лівої дужки, тобто, "("
- Рядкового відображення часового поясу, що залежить від реалізації, і може бути скороченням повної назви (не існує стандарту для імен чи скорочень часових поясів), наприклад, "Line Islands Time" або "LINT"
- Правої дужки, тобто, ")"
Приклад: "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
був екземпляром Date
. Однак, він повинен мати внутрішню властивість [[TimeValue]]
, яку неможливо створити за допомогою вбудованих методів javascript, тому він обмежений використанням з екземплярами Date
. Якщо метод викликається не на екземплярі Date, викидається TypeError
.
Приклади
Використання toString()
Наступний код присвоює значення toString()
об'єкта Date
змінній myVar
:
var x = new Date();
var myVar = x.toString(); // присвоює рядкове значення myVar у такому форматі:
// Mon Sep 08 1998 14:36:22 GMT-0700 (PDT)
Специфікації
Специфікація |
---|
ECMAScript (ECMA-262) The definition of 'Date.prototype.toString' in that specification. |
Сумісність з веб-переглядачами
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.