JS метод Date.setMinutes()

Загальний опис

Date.prototype.setMinutes() - це метод об'єкта Date у JavaScript, який дозволяє встановити хвилини для конкретного об'єкта дати, при цьому інші компоненти часу залишаються незмінними. Цей метод корисний, коли потрібно змінити або коригувати хвилини в існуючому об'єкті дати без зміни інших елементів дати чи часу.

Приклад:

let eventDate = new Date('2023-09-19T14:30:00');
eventDate.setMinutes(45);
console.log(eventDate); // Виводить "Tue Sep 19 2023 14:45:00 GMT+0200"

У цьому прикладі ми створили об'єкт дати для події, запланованої на 14:30, а потім використали setMinutes(), щоб змінити час початку події на 14:45.

Якщо передане значення виходить за межі вище зазначеного діапазону, Date об'єкт коригується відповідно. Наприклад, якщо ви вкажете 70 хвилин, то година буде збільшена на 1, а хвилини буде встановлено в 10.

Продовжуючи приклад, розглянемо випадок, коли користувач хоче встановити час завершення події як через 90 хвилин після її початку:

let endDate = new Date(eventDate);
endDate.setMinutes(eventDate.getMinutes() + 90);
console.log(endDate); // Виводить час завершення події, який на 1 годину 30 хвилин більший від часу початку.

Date.prototype.setMinutes() - це мутуючий метод, тобто він змінює об'єкт дати безпосередньо. Якщо вам потрібно зберегти початковий об'єкт дати незмінним і працювати з копією, переконайтеся, що ви створюєте новий екземпляр об'єкта дати перед використанням цього методу.

Нотатка:	Пам'ятайте, що значення, передане у `setMinutes()`, може вийти за рамки 0-59. Якщо це станеться, метод автоматично скоригує години в об'єкті дати. Тому завжди контролюйте введені значення.
Нотатка:	При роботі з методом `Date.prototype.setMinutes()`, важливо пам'ятати, що об'єкти `Date` в JavaScript завжди зберігаються в UTC. Однак при виведенні вони перетворюються в локальний часовий пояс. Це може призвести до неочікуваних результатів, особливо при роботі з різними часовими поясами.
Нотатка:	Метод `setMinutes()` може бути використаний разом з іншими методами, такими як `setHours()`, `setSeconds()` або `setMilliseconds()`, щоб здійснити точні та складні корекції часу. Це може бути особливо корисно при створенні службових функцій для обробки дати та часу в складних сценаріях.
Порада:	Якщо вам потрібно внести зміни до об'єкта дати, рекомендуємо створювати новий екземпляр дати з існуючої, а потім застосовувати до нього метод `Date.prototype.setMinutes()`. Таким чином, ви зберігаєте первісний об'єкт дати без змін. Приклад: `let initialDate = new Date('2023-09-19T14:30:00'); let modifiedDate = new Date(initialDate); modifiedDate.setMinutes(45);`

Синтаксис

setMinutes(minutesValue)
setMinutes(minutesValue, secondsValue)
setMinutes(minutesValue, secondsValue, msValue)

Параметри

*minutesValue: Ціле число від 0 до 59, що представляє хвилини.
secondsValue: Ціле число від 0 до 59, що представляє секунди. Якщо ви вказуєте параметр secondsValue, то обов'язково маєте вказати і minutesValue.
msValue: Ціле число від 0 до 999, що представляє мілісекунди. Якщо ви вказуєте параметр msValue, то обов'язково маєте вказати і minutesValue та secondsValue.

Return

timestamp: Метод змінює об'єкт Date "на місці" і повертає новий штамп часу (timestamp) у мілісекундах. Якщо який-небудь з параметрів є NaN (або іншими значеннями, які конвертуються в NaN, такими як undefined), то дата встановлюється як "Invalid Date", і метод повертає NaN.

Переглядачі

Переглядач
	1	1	1	3	12

Переглядач
	4.4	18	4	1

Переглядач
	0.10.0	1.0

Приклади

У цьому прикладі ми демонструємо використання методу setMinutes() для додавання заданої кількості хвилин до поточного часу. Користувач може вказати кількість хвилин, яку він бажає додати до поточного часу, натиснути кнопку "Додати", і він побачить оновлений час.


  See the Pen <a href="https://codepen.io/css_in_ua/pen/xxmPpqx">
  Untitled</a> by css.in.ua (<a href="https://codepen.io/css_in_ua">@css_in_ua</a>)
  on <a href="https://codepen.io">CodePen</a>.

У цьому прикладі ми спочатку створюємо об'єкт дати з поточним часом. Потім ми отримуємо поточні хвилини з допомогою методу getMinutes() і додаємо до них 20. Результат записуємо назад у об'єкт дати за допомогою setMinutes(). Таким чином, ми "перемотуємо" час на 20 хвилин вперед і виводимо обидва часи (початковий і оновлений) в консоль для порівняння.

// Створення дати з поточним часом
let now = new Date();

// Виведення поточного часу
console.log("Початковий час:", now);

// Додаємо 20 хвилин до поточного часу
let newMinutes = now.getMinutes() + 20;
now.setMinutes(newMinutes);

// Виведення обновленого часу
console.log("Оновлений час:", now);

У цьому прикладі ми створили дату з часом 14:30. Потім ми використовуємо метод setMinutes() для зміни хвилин на 45. Результатом буде новий час 14:45, який ми виводимо в консоль.

// Створення початкової дати з конкретним часом
let date = new Date('2023-09-19T14:30:00');

// Встановлюємо хвилини на значення "45"
date.setMinutes(45);

console.log(date); // Виведе: 2023-09-19T14:45:00

JS довідник

JavaScript

Наповнення JS розділу