JS метод Date.getUTCDate()

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

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

Розглянемо простий приклад:

let currentDate = new Date();
let day = currentDate.getUTCDate();
console.log(day);

У цьому прикладі ми створюємо новий об'єкт Date, що представляє поточний момент часу, а потім отримуємо день місяця в UTC. Якщо сьогодні 15-те число, програма виведе 15.

Основна особливість методу getUTCDate() полягає в тому, що він повертає значення відповідно до UTC, а не місцевого часу. Це відрізняє його від методу getDate(), який повертає день місяця відповідно до місцевого часу. Так, наприклад, якщо у вас 1-е січня 1 година ночі в Нью-Йорку, то метод getDate() поверне 1, а getUTCDate() - можливо, 31 (залежно від того, який місяць і рік).

Важливо знати, що getUTCDate() повертає значення типу Number. Це діапазон значень від 1 до 31, що відповідає дню місяця. Якщо дата була створена за допомогою конструктора Date без вказівки дати (наприклад, через Date.now() або просто new Date()), то цей метод повертає день місяця для поточної дати.

Нотатка:	Що таке UTC? Це всесвітній стандарт часу. Коли ми говоримо про час в UTC, ми маємо на увазі час, який не змінюється із зміною сезонів або зміщенням годинникового поясу. Важливо зрозуміти різницю між місцевим часом і UTC, особливо при роботі з базами даних або інтернаціональними системами.
Нотатка:	Також добре розуміти різницю між різними UTC-методами в `Date`. Наприклад, `getUTCDay()` повертає день тижня (від 0 до 6), а `getUTCDate()` - день місяця (від 1 до 31).
Порада:	Завжди пам'ятайте, що результат виклику методу `Date.prototype.getUTCDate()` знаходиться у діапазоні від 1 до 31. Це може бути корисним, коли вам потрібно переконатися, що отримане значення є дійсним числом дня місяця. Наприклад, якщо ваше число виходить за ці межі, це може свідчити про помилку у вашому коді.
Порада:	Якщо ви розробляєте програмне забезпечення, яке буде використовуватися в різних часових поясах, завжди намагайтеся використовувати методи UTC (як `getUTCDate()`), щоб уникнути можливих помилок, пов'язаних з місцевим часом.

Синтаксис

getUTCDate()

Параметри

Return

integer: Повертає число місяця (від 1 до 31) для вказаної дати за координованим універсальним часом (UTC).

Переглядачі

Переглядач
	1	1	1	4	12

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

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

Приклади

У цьому прикладі ми демонструємо, як отримати UTC-день місяця використовуючи метод getUTCDate(). Користувач може натиснути на кнопку, щоб побачити поточний UTC-день місяця, який буде відображено під кнопкою.


  See the Pen <a href="https://codepen.io/css_in_ua/pen/LYMjGQz">
  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, що представляє поточну дату та час. Після цього, використовуючи метод getUTCDate(), ми отримуємо день місяця за UTC і виводимо його на екран.

// Створюємо новий об'єкт Date
let currentDate = new Date();

// Отримуємо поточний UTC-день місяця
let utcDay = currentDate.getUTCDate();

console.log(`Сьогодні {utcDay}-й день місяця за UTC.`);

У цьому прикладі ми визначаємо, чи сьогодні за UTC останній день місяця. Ми створюємо новий об'єкт Date для поточної дати та отримуємо поточний UTC-день. Далі ми створюємо новий об'єкт Date для першого дня наступного місяця, а потім віднімаємо один день від цієї дати, щоб отримати дату останнього дня поточного місяця. На кінець ми порівнюємо дні, щоб дізнатися, чи сьогодні останній день місяця.

// Створюємо новий об'єкт Date для поточної дати
let currentDate = new Date();

// Отримуємо поточний UTC-день місяця
let currentUTCDay = currentDate.getUTCDate();

// Створюємо новий об'єкт Date для першого дня наступного місяця
let nextMonth = new Date(currentDate.getUTCFullYear(), currentDate.getUTCMonth() + 1, 1);

// Віднімаємо один день, щоб отримати останній день поточного місяця
nextMonth.setUTCDate(nextMonth.getUTCDate() - 1);

// Отримуємо день останнього дня поточного місяця
let lastUTCDay = nextMonth.getUTCDate();

// Перевіряємо, чи сьогодні останній день місяця
if (currentUTCDay === lastUTCDay) {
    console.log("Сьогодні останній день місяця за UTC.");
} else {
    console.log("Сьогодні не останній день місяця за UTC.");
}

JS довідник

JavaScript

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