css.in.ua
Підтримати

JS метод Date.getUTCFullYear()

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

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

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

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

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

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

Цей метод відрізняється від 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-функція обраховує різницю між роками, але також враховує місяці та дні, щоб отримати точний розрахунок.

Цей приклад демонструє, як визначити, чи є поточний рік високосним, використовуючи 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()} року.`);
}

Спільнота

Зв'язок