JS метод Date.setUTCMilliseconds()
Загальний опис
Date.prototype.setUTCMilliseconds()
є методом об'єкта Date
, який дозволяє встановити значення мілісекунд, використовуючи Координований світовий час (UTC). Він є частиною стандартних об’єктів JavaScript, і його основне призначення - допомагати розробникам точно контролювати час в мілісекундах для дат, особливо коли треба враховувати часові пояси.
Цей метод корисний, коли вам потрібно внести зміни в мілісекунди конкретного об'єкта Date
, але хочете залишити інші компоненти часу незмінними. Зокрема, його можна використовувати в ситуаціях, коли користувачам необхідно виводити або вводити дату та час в різних часових поясах.
Цей метод приймає один аргумент, який представляє кількість мілісекунд (від 0 до 999), які потрібно встановити.
Приклад:
let date = new Date('December 17, 2023 03:24:00 UTC');
date.setUTCMilliseconds(789);
console.log(date.getUTCMilliseconds()); // 789
У цьому прикладі ми створюємо новий об'єкт Date
і використовуємо setUTCMilliseconds()
для встановлення мілісекунд в 789. Далі, ми виводимо значення мілісекунд за допомогою getUTCMilliseconds()
, яке підтверджує, що мілісекунди було встановлено правильно.
Порада: | Для кращого розуміння, як працює |
Порада: | Переконайтеся, що ви правильно передаєте аргументи в
|
Порада: | Досвідчені розробники можуть використовувати |
Синтаксис
setUTCMilliseconds(millisecondsValue)
Параметри
- *
millisecondsValue
Це число, яке представляє мілісекунди, які будуть встановлені для об'єкта
Date
. Це має бути ціле число від 0 до 999. Якщо значення виходить за цей діапазон, відбувається переповнення, і відповідно змінюється секунда, хвилина, година та інші більш великі одиниці часу.
Return
timestamp
Метод модифікує об'єкт
Date
і повертає новий часовий штамп (timestamp
) у мілісекундах. ЯкщоmillisecondsValue
єNaN
(або іншими значеннями, які перетворюються наNaN
, наприкладundefined
), то дата встановлюється як недійсна ("Invalid Date"), і повертаєтьсяNaN
.
Переглядачі
Переглядач | |||||
---|---|---|---|---|---|
1 |
1 |
1 |
4 |
12 |
Переглядач | ||||
---|---|---|---|---|
4.4 |
18 |
4 |
1 |
Переглядач | ||
---|---|---|
0.10.0 |
1.0 |
Приклади
Цей приклад демонструє використання методу setUTCMilliseconds()
, дозволяючи користувачеві вводити кількість мілісекунд і бачити, як це впливає на об'єкт Date
.
У цьому прикладі створюється новий об'єкт date
, який представляє собою конкретний час та дату. За допомогою console.log
ми виводимо початкові мілісекунди, які дорівнюють 0. Далі, з допомогою Date.prototype.setUTCMilliseconds()
, ми встановлюємо мілісекунди на 456 і знову виводимо їх з допомогою console.log
.
// Створення нового об'єкта Date
let date = new Date('2023-09-23T15:00:00Z');
// Вивід поточних мілісекунд
console.log('Початкові мілісекунди:', date.getUTCMilliseconds()); // 0
// Встановлення мілісекунд в 456
date.setUTCMilliseconds(456);
// Вивід оновлених мілісекунд
console.log('Оновлені мілісекунди:', date.getUTCMilliseconds()); // 456
Цей приклад демонструє, як можна синхронізувати мілісекунди між двома об'єктами date
. Ми створюємо два об'єкта date1
та date2
із різними датами та часами. Після цього, ми встановлюємо мілісекунди для date1
у 123 за допомогою Date.prototype.setUTCMilliseconds()
та потім синхронізуємо мілісекунди date1
з date2
, встановлюючи для date2
такі ж мілісекунди, які є у date1
.
// Створення двох різних об'єктів Date
let date1 = new Date('2023-09-23T15:00:00Z');
let date2 = new Date('2023-09-24T18:30:00Z');
// Вивід мілісекунд для обох дат
console.log('Мілісекунди date1:', date1.getUTCMilliseconds()); // 0
console.log('Мілісекунди date2:', date2.getUTCMilliseconds()); // 0
// Встановлення мілісекунд для date1 в 123
date1.setUTCMilliseconds(123);
// Синхронізація мілісекунд з date1 у date2
date2.setUTCMilliseconds(date1.getUTCMilliseconds());
// Вивід оновлених мілісекунд для обох дат
console.log('Оновлені мілісекунди date1:', date1.getUTCMilliseconds()); // 123
console.log('Оновлені мілісекунди date2:', date2.getUTCMilliseconds()); // 123