diff options
Diffstat (limited to 'files/uk/web/javascript/reference/global_objects/date/setmonth/index.html')
| -rw-r--r-- | files/uk/web/javascript/reference/global_objects/date/setmonth/index.html | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/files/uk/web/javascript/reference/global_objects/date/setmonth/index.html b/files/uk/web/javascript/reference/global_objects/date/setmonth/index.html new file mode 100644 index 0000000000..6776be81f5 --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/date/setmonth/index.html @@ -0,0 +1,83 @@ +--- +title: Date.prototype.setMonth() +slug: Web/JavaScript/Reference/Global_Objects/Date/setMonth +tags: + - Date + - JavaScript + - Довідка + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMonth +--- +<div>{{JSRef}}</div> + +<p>Метод <strong><code>setMonth()</code></strong> встановлює місяць для вказаної дати згідно зі встановленим значенням року.</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setmonth.html")}}</div> + +<h2 id="Синтаксис">Синтаксис</h2> + +<pre class="syntaxbox notranslate"><code><var>dateObj</var>.setMonth(<var>monthValue</var>[, <var>dayValue</var>])</code></pre> + +<h3 id="Версії_до_JavaScript_1.3">Версії до JavaScript 1.3</h3> + +<pre class="syntaxbox notranslate"><code><var>dateObj</var>.setMonth(<var>monthValue</var>)</code></pre> + +<h3 id="Параметри">Параметри</h3> + +<dl> + <dt><code>monthValue</code></dt> + <dd>Ціле число на основі нуля, що позначає зсув у місяцях від початку року. Отже, 0 позначає січень, 11 - грудень, -1 позначає грудень попереднього року, а 12 - січень наступного року.</dd> + <dt><code>dayValue</code></dt> + <dd>Необов'язковий. Ціле число від 1 до 31, що позначає день місяця.</dd> +</dl> + +<h3 id="Повертає">Повертає</h3> + +<p>Кількість мілісекунд між 1 січня 1970 року 00:00:00 за UTC та оновленою датою.</p> + +<h2 id="Опис">Опис</h2> + +<p>Якщо ви не вказуєте параметр <code>dayValue</code>, використовується значення, яке повертає метод {{jsxref("Date.prototype.getDate()", "getDate()")}}.</p> + +<p>Якщо вказаний вами параметр знаходиться за межами очікуваного діапазону, <code>setMonth()</code> пробує оновити інші параметри та інформацію про дату у об'єкті {{jsxref("Date")}} відповідно. Наприклад, якщо ви вкажете 15 в якості <code>monthValue</code>, рік буде збільшений на 1, а 3 буде значенням місяця.</p> + +<p>Поточний день місяця впливатиме на поведінку цього методу. Концептуально, він додасть кількість днів, надану поточним значенням дня місяця, до першого дня нового місяця, вказаного у параметрі, щоб повернути нову дату. Наприклад, якщо існуючим значенням є 31-ше серпня 2016, виклик setMonth зі значенням 1 поверне 2 березня 2016. Все тому, що у лютому 2016 було 29 днів.</p> + +<h2 id="Приклади">Приклади</h2> + +<h3 id="Використання_setMonth">Використання <code>setMonth()</code></h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setMonth(6); + +// Стережіться переходів у кінці місяця +var endOfMonth = new Date(2016, 7, 31); +endOfMonth.setMonth(1); +console.log(endOfMonth); //Wed Mar 02 2016 00:00:00 +</pre> + +<h2 id="Специфікації">Специфікації</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Специфікація</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setmonth', 'Date.prototype.setMonth')}}</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.setMonth")}}</p> + +<h2 id="Див._також">Див. також</h2> + +<ul> + <li>{{jsxref("Date.prototype.getMonth()")}}</li> + <li>{{jsxref("Date.prototype.setUTCMonth()")}}</li> +</ul> |
