getYear() 算是歷史悠久的方法,早期使用一直沒什麼問題,但跨入 2000 年之後麻煩就來了。在 Firefox、Safari 等瀏覽器上,getYear 一律回傳「年份與 1900 年之間的差值」——1998 年回傳 98,2009 年則回傳 109。如果大家都照這套規則走倒也罷了,偏偏微軟在 IE 中自行把它「修正」了,而 Firefox(即使到後續版本)仍照舊規矩解析。本來還能寄望開發者各自補上轉換,如今兩邊規則不一致,反而誰都用不了,於是 getFullYear 與 getUTCFullYear 便應運而生。
getYear() 回傳的年份可能是兩位數,也可能是四位數:落在 1900 至 1999 年間只回傳兩位數,早於或晚於此區間則回傳四位數。以 2009 年為例,JavaScript 解析器理應回傳 2009,但瀏覽器卻計算成 109——這應該是早期的約定,而 IE 私自把它改掉了。此函式已逐漸被棄用,不建議再使用。
<script type="text/javascript">
var d = new Date();
document.write(d.getYear());//IE輸出2009,FIREFOX輸出109
</script>
getFullYear() 就沒有這個問題,它一律回傳四位數年份,IE 與 Firefox 都不必再做運算,直接輸出解析值即可。
<script type="text/javascript">
var d = new Date();
document.write(d.getFullYear());//IE輸出2009,FIREFOX輸出2009
</script>
getUTCFullYear() 則是依據 UTC 時間回傳四位數年份。從理論角度來看,它與 getFullYear() 完全不同:絕大多數時間兩者輸出一致,但當日期落在 12 月 31 日或 1 月 1 日這類交界點時,返回值就可能不同,取決於當地時區與 UTC 之間的差值。
<script type="text/javascript">
var d = new Date();
document.write(d.getUTCFullYear());//IE輸出2009,FIREFOX輸出2009
</script>
舉例來說,中國大陸、香港、澳門、蒙古、台灣、新加坡、馬來西亞、菲律賓等地的本地時間比 UTC 快 8 小時,記為 UTC+8;反之則類似 UTC-10 的寫法。理解這個差值,就能判斷跨年時刻為何兩者會不一致。