DIV CSS 佈局教程網

微信與 QQ 風格聊天時間顯示的實作:從自然日改為日曆日的完整演進
編輯:JavaScript基礎知識     

聊天介面上的時間顯示是個容易被低估的需求。看起來只是格式化日期,實際上牽涉「兩分鐘內不顯示」、「昨天要顯示昨天」、「跨年怎麼辦」等一堆邊界條件。本文記錄這個方法從初稿到定版的整個修正過程,包含程式碼與踩過的坑。

一、初版:以時間差為判斷依據

/**
 * 將時間戳轉為提示性時間字串:
 * 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 版本短得多,也不必自己處理閏年與月末的邊界。

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