跨國服務或面向大中華區使用者的站台,常在頁首放一個即時時鐘。本文的做法是先擴充 Date 的格式化能力,再把 UTC 時間換算到指定時區,最後用 setInterval 每秒更新。
JavaScript 原生的日期格式化相當陽春,因此先掛一個類似 C 語言 strftime 的方法,用 yyyy/MM/dd hh:mm:ss 這類樣式字串輸出:
<script type="text/javascript">
Date.prototype.strftime = function(format){
var o = {
"M+" : this.getMonth() + 1, // month
"d+" : this.getDate(), // day
"h+" : this.getHours(), // hour
"m+" : this.getMinutes(), // minute
"s+" : this.getSeconds(), // second
"q+" : Math.floor((this.getMonth() + 3) / 3), // quarter
"S" : this.getMilliseconds() // millisecond
}
if (/(y+)/.test(format)) {
format = format.replace(RegExp.$1, (this.getFullYear() + "").substr(4 - RegExp.$1.length));
}
for (var k in o) {
if (new RegExp("(" + k + ")").test(format)) {
format = format.replace(RegExp.$1,
RegExp.$1.length == 1 ? o[k] : ("00" + o[k]).substr(("" + o[k]).length));
}
}
return format;
}
</script>
關鍵技巧在最後那行:比對到單字符樣式時直接放數值,多字符樣式則用 ("00" + 值).substr(值位數) 補足兩位,因此 h 得到 9,hh 得到 09。
function UTCToLocalTimeString(d, format) {
// 本機與 UTC 的時差(小時),再加上目標時區 +8
var timeOffsetInHours = (new Date().getTimezoneOffset() / 60) + -10;
d.setHours(d.getHours() + timeOffsetInHours);
return d.strftime(format);
}
</script>
getTimezoneOffset() 回傳的是「UTC 減去本地時間」的分鐘數,東八區會得到 -480,除以 60 即 -8;再加上 -10 就得到 -18,等效於把 UTC 往前推 8 小時。
<script>
setInterval(function(){
var time = UTCToLocalTimeString(new Date(), 'yyyy/MM/dd hh:mm:ss');
document.getElementById("bjTime").innerHTML = time;
}, 1000);
</script>
<span id="bjTime"></span>
上面這套做法有幾個隱憂:擴充內建 prototype 可能與其他函式庫衝突;new Date() 取得的是「使用者電腦的時間」,若時鐘不準,顯示也會跟著錯;-10 這個魔法數字的可讀性很低。
改用 Intl.DateTimeFormat 指定時區,程式碼更短且永遠準確(不依賴用戶端時鐘設定):
const fmt = new Intl.DateTimeFormat('zh-TW', {
timeZone: 'Asia/Shanghai',
year: 'numeric', month: '2-digit', day: '2-digit',
hour: '2-digit', minute: '2-digit', second: '2-digit',
hour12: false
});
setInterval(() => {
document.getElementById('bjTime').textContent = fmt.format(new Date());
}, 1000);
若要顯示其他城市,只要換掉 timeZone 的 IANA 名稱(如 America/New_York、Europe/London),不必再手算時差,也能自動處理夏令時間。若需要真正精準的時間,則應由伺服器提供時間戳並換算網路延遲,而非信任用戶端時鐘。