JS метод Date.setUTCMinutes()

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

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

Метод Date.prototype.setUTCMinutes використовується, коли потрібно задати конкретне значення хвилин для об’єкта дати в UTC, без змінення інших компонентів дати. Це особливо корисно у ситуаціях, коли розробники хочуть уникнути проблем, пов’язаних із літнім часом, або коли потрібно синхронізувати час із сервером. Зазвичай, цей метод застосовується в сферах, де висока точність часу є критичною, таких як фінансові послуги, авіація та телекомунікації.

Синтаксис виглядає так:

dateObj.setUTCMinutes(minutesValue[, secondsValue[, msValue]])

Тут minutesValue — це хвилини, які ви хочете встановити (від 0 до 59). Опціональні параметри secondsValue та msValue дозволяють встановити секунди та мілісекунди відповідно.

Ось простий приклад використання:

let date = new Date('2023-09-23T15:30:00Z'); // UTC час
date.setUTCMinutes(45);
console.log(date.toISOString()); // Виведе: 2023-09-23T15:45:00.000Z

У цьому прикладі, ми створили новий об'єкт дати і використали setUTCMinutes для зміни хвилин на 45, тоді як інші компоненти часу залишаються без змін.

При встановленні значень, які виходять за рамки валідного діапазону (наприклад, хвилини вище 59), JavaScript автоматично коригує дату і час. Наприклад, якщо ви встановите 65 хвилин, то метод додасть 1 годину і 5 хвилин до поточного часу.

let date = new Date('2023-09-23T15:30:00Z');
date.setUTCMinutes(65);
console.log(date.toISOString()); // Виведе: 2023-09-23T16:05:00.000Z

Нотатка:	Метод `Date.prototype.setUTCMinutes` відрізняється від методу `Date.prototype.setMinutes`, який встановлює хвилини відповідно до місцевого часу, не враховуючи UTC.
Порада:	Перед використанням `Date.prototype.setUTCMinutes` завжди переконайтеся, що об'єкт дати існує і є валідним. Невалідні дати можуть викликати несподівані проблеми та помилки в програмі. Зокрема, для новачків, це може бути корисним для уникнення базових помилок при роботі з датами.
Порада:	Для досвідчених розробників, які працюють над великими та складними системами, де важлива точність та продуктивність, рекомендується вивчати альтернативні способи управління часом, такі як бібліотеки `moment.js` або `date-fns`. Вони можуть надати більше можливостей та гнучкості при роботі з датами і часом.

Синтаксис

setUTCMinutes(minutesValue)
setUTCMinutes(minutesValue, secondsValue)
setUTCMinutes(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	4	12

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

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

Приклади

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


  See the Pen <a href="https://codepen.io/css_in_ua/pen/mdaXzGX">
  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>.

У другому прикладі ми знову створюємо новий об'єкт date, але цього разу ми встановлюємо 90 хвилин і 15 секунд за допомогою методу Date.prototype.setUTCMinutes. JavaScript автоматично регулює значення хвилин, тому 90 хвилин конвертуються у 1 годину та 30 хвилин, тому кінцевий час стає 14:00:15.

// Створення нового об'єкта дати
let date = new Date('2023-09-23T12:30:00Z'); // 23 вересня 2023, 12:30 за UTC

// Змінення хвилин та секунд UTC часу
date.setUTCMinutes(90, 15); // Встановлення 90 хвилин і 15 секунд

// Виведення результату
console.log(date.toISOString()); // 2023-09-23T14:00:15.000Z

У цьому прикладі демонструється, як додати 10 хвилин до поточного UTC часу. Використовуючи методи getUTCMinutes та getUTCSeconds, ми отримуємо поточні хвилини та секунди. Потім, за допомогою Date.prototype.setUTCMinutes, ми встановлюємо нове значення хвилин, що дорівнює поточному значенню хвилин з додаванням 10 хвилин, та показуємо оновлений час.

// Створення об'єкта дати для поточного часу
let now = new Date();

// Виведення поточного часу UTC перед змінами
console.log('Початковий час UTC:', now.toISOString());

// Отримання поточних хвилин та секунд UTC часу
let minutes = now.getUTCMinutes();
let seconds = now.getUTCSeconds();

// Розрахунок нових хвилин з додаванням 10 хвилин
let newMinutes = minutes + 10;

// Встановлення нових хвилин та секунд
now.setUTCMinutes(newMinutes, seconds);

// Виведення часу UTC після змін
console.log('Оновлений час UTC:', now.toISOString());

JS довідник

JavaScript

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