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(), яке підтверджує, що мілісекунди було встановлено правильно.

автор: Bond

Порада

Для кращого розуміння, як працює Date.prototype.setUTCMilliseconds(), створіть декілька дат з різними мілісекундами та спробуйте встановити нові мілісекунди. Після кожної зміни виведіть результат, використовуючи console.log, щоб побачити, як змінилися мілісекунди.

автор: Bond

Порада

Досвідчені розробники можуть використовувати Date.prototype.setUTCMilliseconds() для оптимізації високопродуктивних систем. Наприклад, при обробці великих масивів даних із часовими мітками, враховуйте, як ви можете використовувати цей метод для підвищення точності та ефективності вашого коду.

автор: Bond

Порада

Переконайтеся, що ви правильно передаєте аргументи в Date.prototype.setUTCMilliseconds(). Цей метод очікує одне значення: кількість мілісекунд від 0 до 999. Неправильно введені аргументи можуть призвести до неочікуваних результатів.

let date = new Date();
date.setUTCMilliseconds(1000); // Неправильно: має бути в межах 0-999
date.setUTCMilliseconds(999); // Правильно

автор: Bond

Синтаксис

setUTCMilliseconds(millisecondsValue)

Параметри

millisecondsValue

Це число, яке представляє мілісекунди, які будуть встановлені для об'єкта Date. Це має бути ціле число від 0 до 999. Якщо значення виходить за цей діапазон, відбувається переповнення, і відповідно змінюється секунда, хвилина, година та інші більш великі одиниці часу.

автор: Bond

Повернення

timestamp

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

автор: Bond

Переглядачі

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

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

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

Приклади

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

Цей приклад демонструє, як можна синхронізувати мілісекунди між двома об'єктами 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

автор: Bond

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

автор: Bond

У цьому прикладі створюється новий об'єкт 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

автор: Bond

Коментарі

Коментарів ще немає — будьте першим!