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

правити

Порада

Якщо ви створюєте функції або бібліотеки для роботи з датами, розгляньте можливість інтеграції з іншими часовими бібліотеками, як-от moment.js. Це дозволить вам використовувати getUTCFullYear() для отримання базового значення року і потім легко маніпулювати цими датами з додатковими функціями, що надають ці бібліотеки.

автор: Bond правити

Порада

Якщо ваш додаток або веб-сайт використовується в різних часових поясах, завжди використовуйте методи з префіксом "UTC", зокрема Date.prototype.getUTCFullYear(), щоб уникнути неочікуваних відхилень в датах. Це забезпечує консистентність виведення даних для всіх користувачів.

Приклад:

let date = new Date();
let localYear = date.getFullYear(); 
let utcYear = date.getUTCFullYear();
console.log(`Локальний рік: ${localYear}, UTC рік: ${utcYear}`);

автор: Bond правити

Порада

Перед використанням методу getUTCFullYear() завжди переконуйтеся, що ви працюєте з екземпляром об'єкта Date. Це запобігає виникненню помилок у випадку, якщо ви намагаєтеся викликати цей метод з несумісного типу.

Приклад:

if(date instanceof Date) {
   console.log(date.getUTCFullYear());
}

автор: Bond правити

Нотатка

Для новачків важливо розрізняти Date.prototype.getUTCFullYear() від Date.prototype.getFullYear(). Перший повертає рік в UTC, тоді як другий - в локальному часовому поясі. Неправильне використання може призвести до неточностей в даних.

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

getUTCFullYear()

Повернення

integer

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

автор: Bond

правити

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

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

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

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

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

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

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

Приклади

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

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} не є високосним роком.`);
}

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()} року.`);
}