diff options
Diffstat (limited to 'files/uk/web/javascript/reference/global_objects/date/tostring/index.html')
| -rw-r--r-- | files/uk/web/javascript/reference/global_objects/date/tostring/index.html | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/files/uk/web/javascript/reference/global_objects/date/tostring/index.html b/files/uk/web/javascript/reference/global_objects/date/tostring/index.html new file mode 100644 index 0000000000..c3c2c9a0b8 --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/date/tostring/index.html @@ -0,0 +1,110 @@ +--- +title: Date.prototype.toString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toString +tags: + - Date + - JavaScript + - Довідка + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toString +--- +<div>{{JSRef}}</div> + +<p>Метод <strong><code>toString()</code></strong> повертає рядкове представлення вказаного об'єкта {{jsxref("Date")}}.</p> + +<div>{{EmbedInteractiveExample("pages/js/date-tostring.html","shorter")}}</div> + + + +<h2 id="Синтаксис">Синтаксис</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toString()</pre> + +<h3 id="Повертає">Повертає</h3> + +<p>Рядкове представлення наданої дати.</p> + +<h2 id="Опис">Опис</h2> + +<p>Екземпляри {{jsxref("Date")}} успадковують метод <code>toString()</code> від {{jsxref("Date.prototype")}}, а не від {{jsxref("Object.prototype")}}. <code>Date.prototype.toString()</code> повертає рядкове представлення об'єкта Date у форматі, вказаному у ECMA-262, який можна підсумувати наступним чином:</p> + +<ul> + <li>День тижня: 3 літери англійської назви дня тижня, наприклад, "Sat"</li> + <li>пробіл</li> + <li>Місяць: 3 літери англійської назви місяця, наприклад, "Sep"</li> + <li>пробіл</li> + <li>День: 2-значний день місяця, наприклад, "01"</li> + <li>пробіл</li> + <li>Рік: 4-значний рік, наприклад, "2018"</li> + <li>пробіл</li> + <li>Година: 2-значна година, наприклад, "14"</li> + <li>двокрапка</li> + <li>Хвилини: 2-значні хвилини, наприклад, "53"</li> + <li>двокрапка</li> + <li>Секунди: 2-значні секунди, наприклад, "26"</li> + <li>пробіл</li> + <li>Рядок "GMT"</li> + <li>Знак зсуву часового поясу, один з: + <ul> + <li>"+" для додатного зсуву (0 чи більше)</li> + <li>"-" для від'ємного зсуву (менше нуля)</li> + </ul> + </li> + <li>Двозначний зсув годин, наприклад, "14"</li> + <li>Двозначний зсув хвилин, наприклад, "00"</li> + <li>Необов'язково, ім'я часового поясу, що складається з: + <ul> + <li>пробілу</li> + <li>Лівої дужки, тобто, "("</li> + <li>Рядкового відображення часового поясу, що залежить від реалізації, і може бути скороченням повної назви (не існує стандарту для імен чи скорочень часових поясів), наприклад, "Line Islands Time" або "LINT"</li> + <li>Правої дужки, тобто, ")"</li> + </ul> + </li> +</ul> + +<p>Приклад: "Sat Sep 01 2018 14:53:26 GMT+1400 (LINT)"</p> + +<p>До появи ECMAScript 2018 (версії 9) формат рядка, який повертав метод <code>Date.prototype.toString</code>, залежав від реалізації. Тому не можна покладатися на те, що рядок буде у вказаному форматі.</p> + +<p>Метод <code>toString()</code> автоматично викликається, коли дата має бути передана у вигляді текстового значення, наприклад, <code>console.log(new Date())</code>, або коли дата використовується в об'єднанні з рядком, як ось <code>var today = 'Сьогодні ' + new Date()</code>.</p> + +<p><code>toString()</code> є загальним методом, він не вимагає, щоб його <code>this</code> був екземпляром {{jsxref("Date")}}. Однак, він повинен мати внутрішню властивість <code>[[TimeValue]]</code>, яку неможливо створити за допомогою вбудованих методів javascript, тому він обмежений використанням з екземплярами {{jsxref("Date")}}. Якщо метод викликається не на екземплярі Date, викидається {{jsxref("TypeError")}}.</p> + +<h2 id="Приклади">Приклади</h2> + +<h3 id="Використання_toString">Використання <code>toString()</code></h3> + +<p>Наступний код присвоює значення <code>toString()</code> об'єкта {{jsxref("Date")}} змінній <code>myVar</code>:</p> + +<pre class="brush: js notranslate">var x = new Date(); +var myVar = x.toString(); // присвоює рядкове значення myVar у такому форматі: + // Mon Sep 08 1998 14:36:22 GMT-0700 (PDT) +</pre> + +<h2 id="Специфікації">Специфікації</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Специфікація</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.tostring', 'Date.prototype.toString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2> + +<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("javascript.builtins.Date.toString")}}</p> + +<h2 id="Див._також">Див. також</h2> + +<ul> + <li>{{jsxref("Object.prototype.toString()")}}</li> + <li>{{jsxref("Date.prototype.toDateString()")}}</li> + <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> + <li>{{jsxref("Date.prototype.toTimeString()")}}</li> +</ul> |
