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

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

Порада

Для досвідчених розробників, які працюють над великими та складними системами, де важлива точність та продуктивність, рекомендується вивчати альтернативні способи управління часом, такі як бібліотеки moment.js або date-fns. Вони можуть надати більше можливостей та гнучкості при роботі з датами і часом.

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

Нотатка

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

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

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

Синтаксис

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

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

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

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

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

Приклади

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

// Створення нового об'єкта дати
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

// Створення об'єкта дати для поточного часу
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());