某次把 ASP.NET MVC 後端接上 ExtJS 前端時,卡在日期格式的往返轉換上。問題的起點是:.NET 序列化 DateTime 之後,前端拿到的是一個看不太懂的字串。
例如:
/Date(1335258540000)/
括號裡那串整數,其實是從 1970 年 1 月 1 日 00:00:00 到該 DateTime 之間相隔的毫秒數,也就是所謂的 Unix 時間戳(毫秒版)。
用 eval 可以還原成帶時區的 Date 物件:
var date = eval('new ' + eval('/Date(1335258540000)/').source);
用 alert(date) 檢視結果會更清楚:
Tue Apr 24 17:09:00 UTC+0800 2012
若想繞過 JSON 序列化自行計算,可以寫一個方法:
public long MilliTimeStamp(DateTime TheDate)
{
DateTime d1 = new DateTime(1970, 1, 1);
DateTime d2 = TheDate.ToUniversalTime();
TimeSpan ts = new TimeSpan(d2.Ticks - d1.Ticks);
return (long)ts.TotalMilliseconds;
}
注意 ToUniversalTime() 這一步不可省略,否則會因為時區差而產生偏移。算出來的結果與序列化字串中的整數一致。
反向的問題更棘手:前端的 Date 物件要怎麼送回後端?思路是先在前端用 getTime() 取得毫秒數,後端再把它還原成 DateTime。直覺的寫法如下:
public DateTime ConvertTime(long milliTime)
{
long timeTricks = new DateTime(1970, 1, 1).Ticks + milliTime * 10000;
return new DateTime(timeTricks);
}
實測之後發現時間少了 8 個小時——正好是伺服器所在的東八區時差。也就是說還必須把時區偏移量加回去。
這裡要注意單位:C# 的 Tick 是一千萬分之一秒,而 1 毫秒 = 10000 ticks。一小時 3600 秒,換成 ticks 就是 3600 × 10000000。
修正後的版本:
public DateTime ConvertTime(long milliTime)
{
long timeTricks = new DateTime(1970, 1, 1).Ticks
+ milliTime * 10000
+ TimeZone.CurrentTimeZone.GetUtcOffset(DateTime.Now).Hours * 3600 * (long)10000000;
return new DateTime(timeTricks);
}
上面這版能跑,但仍有兩個隱性風險:一是 GetUtcOffset(...).Hours 取的是整數小時,遇到有 30 或 45 分鐘偏移的時區(如印度、尼泊爾)會失準,應改用 .TotalHours 或直接拿 TimeSpan.Ticks;二是伺服器時區設定若與資料來源不一致,就會產生難以察覺的偏差。
更根本的解法是全程使用 UTC:後端序列化時明確標示 UTC,前端顯示時再轉換為使用者本地時間,傳回時一律以 UTC 毫秒數送出。現代的替代方案則是 ISO 8601 字串(2024-01-01T08:00:00.000Z),它自帶時區資訊、可讀性高,也不依賴 eval,是目前跨語言交換日期的通用選擇。