getUTCFullYear() в JavaScript — рік дати за часом UTC

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

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

<header>
  <h2 class="title">Date.prototype.getUTCFullYear()</h2>
  <p class="description">Метод, який повертає рік заданої дати за координованим світовим часом (UTC).</p>
</header>
<main>
  <div class="result">
    Виберіть дату події: <input type="date" id="eventDate">
    <button onclick="calculateYearsPassed()">Розрахувати роки з моменту події</button>
    <div id="output">Пройшло років: </div>
  </div>
</main>

body {
  font-size: 16px;
  line-height: 1.5;
  font-family: monospace;
}

header {
  background-color: #f1f1f1;
  margin-bottom: 25px;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

header h2.title {
  padding-bottom: 15px;
  border-bottom: 1px solid #999;
}

header p.description {
  font-style: italic;
  color: #222;
}

.result {
  background-color: #f8f8f8;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

function calculateYearsPassed() {
  let eventDate = new Date(document.getElementById("eventDate").value);
  let currentDate = new Date();

  let yearsPassed = currentDate.getUTCFullYear() - eventDate.getUTCFullYear();

  // Коригування року, якщо місяць або день в певному році ще не настав
  if (currentDate.getUTCMonth() < eventDate.getUTCMonth() ||
  currentDate.getUTCMonth() === eventDate.getUTCMonth() && currentDate.getUTCDate() < eventDate.getUTCDate()) {
    yearsPassed--;
  }

  document.getElementById("output").innerText = "Пройшло років: " + yearsPassed;
}
//# sourceURL=pen.js

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