DIV CSS 佈局教程網

Ajax 拿到 Date 型別的資料時,為什麼變成一串數字
編輯:AJAX基礎知識     

後端明明回傳的是日期,前端拿到的卻是 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 沒有日期型別

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 頁面。不過這個標頭可以被偽造,正式環境不應作為唯一的判斷依據。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved