Computer >> Hướng Dẫn Máy Tính >  >> Lập Trình >> JavaScript

Phương thức Date.getUTCFullYear() trong JavaScript

Phương thức getUTCFullYear() trả về năm đầy đủ (4 chữ số) của đối tượng Date theo thời gian UTC.

Cú pháp

dateObj.getUTCFullYear()
  • Trả về: Số nguyên năm (ví dụ: 2024, 1989)
  • Không nhận tham số

Ví dụ cơ bản

const date = new Date('1989-09-26T12:04:25.096Z');
console.log(date.getUTCFullYear()); // 1989

const now = new Date();
console.log(now.getUTCFullYear()); // Năm UTC hiện tại

So sánh Local vs UTC Year

// UTC+7, 31/12/2023 23:00 local = 1/1/2024 16:00 UTC
const date = new Date('2023-12-31T23:00:00'); // Local

console.log("Local year:", date.getFullYear());     // 2023
console.log("UTC year:",   date.getUTCFullYear());  // 2024 (qua năm mới UTC)

// 1/1/2024 01:00 local = 31/12/2023 18:00 UTC
const date2 = new Date('2024-01-01T01:00:00');
console.log("Local:", date2.getFullYear());     // 2024
console.log("UTC:",   date2.getUTCFullYear());  // 2023

Ứng dụng

  • Hệ thống quốc tế: năm UTC cho báo cáo, billing cycle
  • Database: lưu năm UTC nhất quán
  • So sánh năm cross-timezone

Lưu ý

  • Luôn trả về năm 4 chữ số
  • Khác với getFullYear() (local) - có thể khác năm ở ranh giới năm mới
  • Trả về NaN nếu Date invalid
  • Cặp đôi với setUTCFullYear()