萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript Date.getUTCMonth() 方法:取得 UTC 月份完整指南

Date.getUTCMonth() 依世界協調時間 (UTC) 回傳 Date 物件的月份值(0-11,0 代表一月),需注意零基底特性。

語法與回傳值

dateObj.getUTCMonth()
// 回傳:Number (0-11),0=一月, 1=二月, ..., 11=十二月

範例代碼

<script>
var dt = new Date();
document.write("getUTCMonth() : " + dt.getUTCMonth());
// 輸出範例: getUTCMonth() : 7 (代表八月)
</script>

月份名稱轉換

var monthNames = [
  "January", "February", "March", "April", "May", "June",
  "July", "August", "September", "October", "November", "December"
];

function getUTCMonthName(date) {
  return monthNames[date.getUTCMonth()];
}

console.log(getUTCMonthName(new Date())); // "August"

完整 UTC 日期組合

function getUTCDateString(date) {
  var y = date.getUTCFullYear();
  var m = (date.getUTCMonth() + 1).toString().padStart(2, '0');
  var d = date.getUTCDate().toString().padStart(2, '0');
  return y + '-' + m + '-' + d;
}

console.log(getUTCDateString(new Date())); // "2024-08-15"

Local vs UTC 月份差異

// 本地 2024-01-01 00:30 (UTC+8)
var local = new Date('2024-01-01T00:30:00+08:00');
console.log('Local Month:', local.getMonth() + 1);    // 1 (一月)
console.log('UTC Month:', local.getUTCMonth() + 1);   // 12 (十二月,前一天)

相關方法對照

項目LocalUTC
月份 (0-11)getMonth()getUTCMonth()
日期 (1-31)getDate()getUTCDate()
年份getFullYear()getUTCFullYear()

注意事項

  • 零基底: 0-11 對應 1-12 月,使用時必須 +1
  • 跨月/跨年邊界時 UTC 月份可能與本地月份不同
  • 無效日期回傳 NaN
  • 格式化輸出建議使用 toISOString() 或 Intl.DateTimeFormat (現代瀏覽器)
copyright © 萬盛學電腦網 all rights reserved