JS метод Date.getUTCFullYear()

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

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

let currentDate = new Date();
console.log(currentDate.getUTCFullYear());  // може вивести, наприклад, 2023

Основна сфера застосування методу - це ситуації, коли вам потрібно створити уніфіковане представлення дати для користувачів у різних часових поясах.

Особливості Date.prototype.getUTCFullYear():

Метод завжди повертає рік у форматі ЧЧЧЧ (наприклад, 2023).
Він не враховує локальний часовий пояс користувача, завжди повертаючи результат за UTC.
Результат відображає актуальний рік дати об'єкта, а не поточний рік в системі.

Цей метод відрізняється від Date.prototype.getFullYear(), який повертає рік в локальному часовому поясі. Це може призвести до плутанини, особливо якщо різниця в часових поясах призводить до зміни дати.

Нотатка:	Для новачків важливо розрізняти `Date.prototype.getUTCFullYear()` від `Date.prototype.getFullYear()`. Перший повертає рік в UTC, тоді як другий - в локальному часовому поясі. Неправильне використання може призвести до неточностей в даних.
Порада:	Якщо ваш додаток або веб-сайт використовується в різних часових поясах, завжди використовуйте методи з префіксом "UTC", зокрема `Date.prototype.getUTCFullYear()`, щоб уникнути неочікуваних відхилень в датах. Це забезпечує консистентність виведення даних для всіх користувачів. Приклад: let date = new Date(); let localYear = date.getFullYear(); let utcYear = date.getUTCFullYear(); console.log(`Локальний рік: ${localYear}, UTC рік: ${utcYear}`);
Порада:	Перед використанням методу `getUTCFullYear()` завжди переконуйтеся, що ви працюєте з екземпляром об'єкта `Date`. Це запобігає виникненню помилок у випадку, якщо ви намагаєтеся викликати цей метод з несумісного типу. Приклад: `if(date instanceof Date) { console.log(date.getUTCFullYear()); }`
Порада:	Якщо ви створюєте функції або бібліотеки для роботи з датами, розгляньте можливість інтеграції з іншими часовими бібліотеками, як-от `moment.js`. Це дозволить вам використовувати `getUTCFullYear()` для отримання базового значення року і потім легко маніпулювати цими датами з додатковими функціями, що надають ці бібліотеки.

Синтаксис

getUTCFullYear()

Параметри

Return

integer: Повертає чотиризначне ціле число, яке відображає рік в часовому поясі UTC для заданого об'єкта дати.

Переглядачі

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

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

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

Приклади

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


  See the Pen <a href="https://codepen.io/css_in_ua/pen/oNJGgwZ">
  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>.

Цей приклад демонструє, як визначити, чи є поточний рік високосним, використовуючи getUTCFullYear(). Функція isLeapYear() приймає рік як аргумент і повертає true, якщо рік є високосним, і false в іншому випадку. Високосний рік визначається так: він повинен ділитися на 4, але не на 100, або ділитися на 400.

function isLeapYear(year) {
    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
}

let currentYear = new Date().getUTCFullYear();
if(isLeapYear(currentYear)) {
    console.log(`${currentYear} є високосним роком.`);
} else {
    console.log(`${currentYear} не є високосним роком.`);
}

У цьому прикладі ми створюємо новий об'єкт Date на основі рядка дати (в форматі ISO). Потім ми порівнюємо рік заданої дати з поточним роком. Щоб отримати роки, ми використовуємо метод getUTCFullYear() для обох дат. На основі порівняння ми виводимо відповідне повідомлення.

let userDate = new Date("2000-01-15T12:00:00Z"); // задана дата
let currentYear = new Date().getUTCFullYear();  // поточний рік

if(userDate.getUTCFullYear() === currentYear) {
    console.log("Задана дата відноситься до поточного року.");
} else {
    console.log(`Задана дата відноситься до ${userDate.getUTCFullYear()} року.`);
}

JS довідник

JavaScript

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