Date.setMinutes() в JavaScript — встановити хвилини

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

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() - це мутуючий метод, тобто він змінює об'єкт дати безпосередньо. Якщо вам потрібно зберегти початковий об'єкт дати незмінним і працювати з копією, переконайтеся, що ви створюєте новий екземпляр об'єкта дати перед використанням цього методу.

правити

Порада

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

Приклад:

let initialDate = new Date('2023-09-19T14:30:00');
let modifiedDate = new Date(initialDate);
modifiedDate.setMinutes(45);

автор: Bond правити

Нотатка

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

автор: Bond правити

Нотатка

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

автор: Bond правити

Нотатка

Метод setMinutes() може бути використаний разом з іншими методами, такими як setHours(), setSeconds() або setMilliseconds(), щоб здійснити точні та складні корекції часу. Це може бути особливо корисно при створенні службових функцій для обробки дати та часу в складних сценаріях.

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

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

Параметри

minutesValue

Ціле число від 0 до 59, що представляє хвилини.

автор: Bond

правити

secondsValue

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

автор: Bond

правити

msValue

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

автор: Bond

правити

Повернення

timestamp

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

автор: Bond

правити

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

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

Підтримка: мобільні переглядачі

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

Підтримка: серверні переглядачі

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

Приклади

+ запропонувати свій приклад у пісочниці

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

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

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

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

<header>
  <h2 class="title">Date.prototype.setMinutes()</h2>
  <p class="description">Метод, який встановлює хвилини для конкретного об'єкта Date.</p>
</header>
<main>
  <div class="result">
    <p>Поточний час: <span id="currentTime"></span></p>
    <label>Додати хвилини:
      <input type="number" id="minutesInput" value="10">
    </label>
    <button onclick="addMinutes()">Додати</button>
    <p>Оновлений час: <span id="updatedTime"></span></p>
  </div>
</main>

body {
  font-size: 16px;
  line-height: 1.5;
  font-family: monospace;
}

header {
  background-color: #f1f1f1;
  margin-bottom: 25px;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

header h2.title {
  padding-bottom: 15px;
  border-bottom: 1px solid #999;
}

header p.description {
  font-style: italic;
  color: #222;
}

.result {
  background-color: #f8f8f8;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

document.getElementById("currentTime").innerText = new Date().toLocaleTimeString();

function addMinutes() {
  let currentDate = new Date();
  let minutesToAdd = parseInt(document.getElementById("minutesInput").value);
  currentDate.setMinutes(currentDate.getMinutes() + minutesToAdd);
  document.getElementById("updatedTime").innerText = currentDate.toLocaleTimeString();
}
//# sourceURL=pen.js

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

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

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