後端明明回傳的是日期,前端拿到的卻是 1400032471285 這樣一串數字。這不是 bug,而是 JSON 協定的必然結果。
前端同時用兩種方式請求同一個端點:
$("#test").click(function (e) {
$.get("/mgr/datacleaning/test", function (data) {
console.log(data + " from $.get()");
});
var xhr = new XMLHttpRequest();
xhr.open("GET", "/mgr/datacleaning/test");
xhr.onreadystatechange = function (e) {
if (xhr.readyState == 4 && xhr.status == 200) {
console.log(xhr.responseText + " from xhr");
}
};
xhr.send(null);
});
後端(Spring):
@ResponseBody
@RequestMapping(value = "/test")
public Date test() {
return new Date();
}
主控台輸出:
1400032471285 from $.get() 1400032471294 from xhr
JSON 規範只定義了 null、boolean、number、string、array、object 六種型別,沒有 date。當 Java 物件被序列化成 JSON 時,Date 只能被轉成某種可表示的型別。多數序列化框架(包含 Jackson 的預設行為)選擇輸出自 1970 年 1 月 1 日 UTC 起的毫秒數,也就是所謂的 epoch timestamp。
所以 1400032471285 其實就是一個完全正確的日期——它是 2014 年 5 月 13 日左右的某個時刻。前端只是需要把它轉回可讀格式。
var ts = 1400032471285; var d = new Date(ts); console.log(d.toLocaleString()); // 依使用者地區格式顯示
Date 建構子接受毫秒數,直接傳入即可。若要格式化,可以自己拼字串,或用 toLocaleString() 讓瀏覽器依地區設定輸出。
若希望後端就回傳可讀格式,有幾種做法。
用 @JsonFormat 指定格式(Jackson):
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8") private Date createTime;
或者乾脆回傳字串:
@ResponseBody
@RequestMapping(value = "/test")
public String test() {
return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date());
}
這兩種做法各有取捨。回傳時間戳的好處是不含時區歧義、數字比較與排序方便、前端可依使用者所在時區自行格式化。回傳格式化字串的缺點是跨時區時容易誤解——伺服器在 UTC+8 格式化後的字串,給 UTC 的使用者看就是錯的時間。
因此實務上的建議是:API 對外一律傳 ISO 8601 格式(如 2026-08-26T18:08:00Z)或 epoch 毫秒數,格式化留給前端依使用者地區處理。這樣同一份資料在不同時區的使用者面前都能正確呈現。
原範例提到 $.get() 的請求標頭比原生 XHR 多了一個 X-Requested-With: XMLHttpRequest。這是 jQuery 自動加的,後端可以藉此區分「Ajax 請求」與「一般頁面請求」,例如決定要回傳 JSON 還是完整 HTML 頁面。不過這個標頭可以被偽造,正式環境不應作為唯一的判斷依據。