JS метод Date.setHours()

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

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

Розглянемо практичний приклад. Припустимо, у вас є веб-сайт, на якому відображається час заходу сонця для різних міст. Однак, час заходу сонця може змінюватися в залежності від певних умов. Щоб динамічно коригувати цей час, можна використовувати Date.prototype.setHours().

let sunset = new Date();
sunset.setHours(19); // Встановлюємо час заходу сонця на 19:00
console.log(sunset);

Тепер, якщо у вас є інформація, що час заходу сонця змінився на 15 хвилин пізніше, ви можете легко скоригувати це:

let minutes = sunset.getMinutes();
sunset.setHours(19, minutes + 15); // Коригуємо час на 15 хвилин пізніше
console.log(sunset);

Крім основної функції встановлення годин, метод також дозволяє встановлювати хвилини, секунди та мілісекунди. Це може бути корисним, наприклад, коли потрібно врахувати часовий пояс користувача та відобразити точний локальний час події:

let userEvent = new Date();
userEvent.setHours(14, 30, 0, 0); // Встановлюємо час події на 14:30:00.000
console.log(userEvent);

правити

Порада

При роботі з методом Date.prototype.setHours() завжди звертайте увагу на поточну часову зону вашої дати. Для уникнення непорозумінь і неточностей, особливо при роботі з глобальними проектами, використовуйте додаткові бібліотеки, такі як Moment.js, які допоможуть вам керувати часовими зонами.

Приклад:

let eventTime = new Date();
eventTime.setHours(15); 
console.log(eventTime); // Ваш локальний час

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

Нотатка

Хоча JavaScript автоматично коригує значення поза допустимим діапазоном (наприклад, 25 годин стануть 1 годиною наступного дня), такі ситуації можуть призвести до неочікуваних результатів. Завжди переконуйтеся, що передаєте коректні значення в setHours().

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

Нотатка

Метод Date.prototype.setHours() приймає не лише години, але й хвилини, секунди та мілісекунди. Це може бути корисно, коли потрібно встановити конкретний момент часу, не користуючись послідовно іншими методами.

Приклад:

let exactTime = new Date();
exactTime.setHours(12, 34, 56, 789);
console.log(exactTime); // 12:34:56.789

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

Нотатка

Методи, такі як setHours(), часто використовуються в комбінації з іншими методами дати для досягнення конкретних результатів. Наприклад, якщо потрібно збільшити дату на певну кількість годин, комбінуйте setHours() з getHours().

Приклад:

let futureTime = new Date();
futureTime.setHours(futureTime.getHours() + 6);
console.log(futureTime); // Текущая дата и время + 6 часов

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

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

Синтаксис

setHours(hoursValue)
setHours(hoursValue, minutesValue)
setHours(hoursValue, minutesValue, secondsValue)
setHours(hoursValue, minutesValue, secondsValue, msValue)

Параметри

hoursValue

Ціле число від 0 до 23, яке представляє години.

автор: Bond

правити

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

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

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

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

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

Приклади

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

// Створюємо новий об'єкт дати для поточного часу
let currentDate = new Date();
console.log("Поточний час:", currentDate);

// Використовуючи метод setHours(), змінюємо годину на 15 (3 година дня)
currentDate.setHours(15);
console.log("Змінений час:", currentDate);

// Створюємо новий об'єкт дати для поточного часу
let now = new Date();
console.log("Поточний час:", now);

// Додаємо 5 годин до поточного часу
let newHour = now.getHours() + 5;
now.setHours(newHour);
console.log("Час після додавання 5 годин:", now);