聊天介面上的時間顯示是個容易被低估的需求。看起來只是格式化日期,實際上牽涉「兩分鐘內不顯示」、「昨天要顯示昨天」、「跨年怎麼辦」等一堆邊界條件。本文記錄這個方法從初稿到定版的整個修正過程,包含程式碼與踩過的坑。
/**
* 將時間戳轉為提示性時間字串:
* 2 分鐘內 → 不顯示
* 2 分鐘-24 小時 → HH:mm
* 昨天 → 昨天 HH:mm
* 前天 → 前天 HH:mm
* 一年內 → MM-DD HH:mm
* 去年 → 去年 MM-DD HH:mm
* 前年 → 前年 MM-DD HH:mm
* 更遠 → yyyy-MM-dd HH:mm
*/
public static String convertChatDetailTimeFormat(long charttime) {
long curTime = System.currentTimeMillis();
long time = curTime - charttime;
if (time < 120 * 1000 && time >= 0) {
return "剛剛";
} else if (time >= 120 * 1000 && time < 3600 * 24 * 1000) {
return format(new Date(charttime), FORMAT_HH_MM);
} else if (time >= 3600 * 24 * 1 * 1000 && time < 3600 * 24 * 2 * 1000) {
return "昨天" + format(new Date(charttime), FORMAT_HH_MM);
} else if (time >= 3600 * 24 * 2 * 1000 && time < 3600 * 24 * 3 * 1000) {
return "前天" + format(new Date(charttime), FORMAT_HH_MM);
} else if (time >= 3600 * 24 * 3 * 1000 && time < 3600 * 24 * 365 * 1000) {
return format(new Date(charttime), FORMAT_MM_DD_HH_MM);
} else if (time >= 3600 * 24 * 365 * 1000 && time < 3600 * 24 * 365 * 2 * 1000) {
return "去年" + format(new Date(charttime), FORMAT_MM_DD_HH_MM);
} else if (time >= 3600 * 24 * 365 * 2 * 1000 && time < 3600 * 24 * 365 * 3 * 1000) {
return "前年" + format(new Date(charttime), FORMAT_MM_DD_HH_MM);
} else if (time >= 3600 * 24 * 365 * 3 * 1000) {
return format(new Date(charttime), FORMAT_LONG_CN_1);
} else {
return "剛剛";
}
}
這個版本有個明顯缺陷:它算的是「距今多少毫秒」,而不是「是否落在今天」。於是昨晚 23:50 傳來的訊息,今天早上 09:00 打開時,時間差只有十小時,落在「2 分鐘到 24 小時」這個區間,於是只顯示 23:50,而不是「昨天 23:50」。測試很快就找上門了。
需求因此調整為:
2 分鐘內 → 不顯示 2 分鐘-今天 → HH:mm 昨天 → 昨天 HH:mm 前天 → 前天 HH:mm 今年 → MM-DD HH:mm 去年 → 去年 MM-DD HH:mm 前年 → 前年 MM-DD HH:mm 更遠 → yyyy-MM-dd HH:mm
接著又出現兩個更棘手的問題。第一是跨年:2015-01-01 00:01 收到的訊息,時間戳其實是 2014-12-31 23:58,該顯示「昨天」還是「去年」?第二是時鐘偏移:若訊息的時間戳竟然比伺服器目前時間還大(裝置時間不準),又該怎麼顯示?
結論是放棄時間差判斷,改成把日期格式化後直接比對字串。這樣「昨天」永遠是日曆上的昨天,不受時間點影響。
/**
* 定版方法:將時間戳轉為提示性時間字串
* 2 分鐘內 → 不顯示
* 2 分鐘-今天 → HH:mm
* 昨天 → 昨天 HH:mm
* 前天 → 前天 HH:mm
* 今年 → MM-DD HH:mm
* 去年 → 去年 MM-DD HH:mm
* 前年 → 前年 MM-DD HH:mm
* 更遠 → yyyy-MM-dd HH:mm
*/
public static String convertWEChartTimeFormatFinalMethed(long time) {
long curTime = System.currentTimeMillis();
String showTimeFormat = "";
long temp = curTime - time;
// 兩分鐘內不顯示
if (temp < 120 * 1000 && temp >= 0) {
return "";
}
Date mayTime = new Date(time);
Date today = new Date();
String mayTimeShort = format(mayTime, FORMAT_SHORT); // yyyy-MM-dd
String mayTimeShortYear = getYear(mayTime); // yyyy
// 時間戳落在未來(裝置時鐘偏差),直接顯示完整時間
if (mayTime.after(today)) {
return format(mayTime, FORMAT_LONG_CN_1);
}
if (mayTimeShort == null || mayTimeShort.trim().equals("")) {
return showTimeFormat;
}
// 今天 yyyy-MM-dd
String todayStr = format(today, FORMAT_SHORT);
String thisYear = getYear(today);
// 昨天 yyyy-MM-dd
Calendar calLastDay = Calendar.getInstance();
calLastDay.setTime(today);
calLastDay.add(Calendar.DAY_OF_YEAR, -1);
String lastDay = format(calLastDay.getTime(), FORMAT_SHORT);
// 前天 yyyy-MM-dd
Calendar calPreviousDay = Calendar.getInstance();
calPreviousDay.setTime(today);
calPreviousDay.add(Calendar.DAY_OF_YEAR, -2);
String previousDay = format(calPreviousDay.getTime(), FORMAT_SHORT);
// 去年 yyyy
Calendar calLastYear = Calendar.getInstance();
calLastYear.setTime(today);
calLastYear.add(Calendar.YEAR, -1);
String lastYear = getYear(calLastYear.getTime());
// 前年 yyyy
Calendar calPreviousYear = Calendar.getInstance();
calPreviousYear.setTime(today);
calPreviousYear.add(Calendar.YEAR, -2);
String previousYear = getYear(calPreviousYear.getTime());
// 依序判斷
if (mayTimeShort.equals(todayStr)) {
showTimeFormat = format(mayTime, FORMAT_HH_MM); // 今天
} else if (mayTimeShort.equals(lastDay)) {
showTimeFormat = "昨天 " + format(mayTime, FORMAT_HH_MM);
} else if (mayTimeShort.equals(previousDay)) {
showTimeFormat = "前天 " + format(mayTime, FORMAT_HH_MM);
} else if (mayTimeShortYear.equals(thisYear)) {
showTimeFormat = format(mayTime, FORMAT_MM_DD_HH_MM); // 今年
} else if (mayTimeShortYear.equals(lastYear)) {
showTimeFormat = "去年 " + format(mayTime, FORMAT_MM_DD_HH_MM);
} else if (mayTimeShortYear.equals(previousYear)) {
showTimeFormat = "前年 " + format(mayTime, FORMAT_MM_DD_HH_MM);
} else {
showTimeFormat = format(mayTime, FORMAT_LONG_CN_1);
}
return showTimeFormat;
}
定版寫法的關鍵轉變是:把「過了多少時間」換成「落在哪一天」。前者受使用者何時打開 App 影響,後者則是客觀事實。同時它也處理了兩個邊界:時間戳在未來時顯示完整時間,避免出現負數或錯亂標籤;兩分鐘內回傳空字串,讓上層自行決定要隱藏還是留白。
若要在新專案中實作類似需求,可以直接用 java.time 的 LocalDate 做日期比對、Duration 算時差,程式碼會比 Calendar 版本短得多,也不必自己處理閏年與月末的邊界。