社群網站的動態時間很少直接顯示「2024-01-05 14:30」,而是「3 天前」這種相對寫法。本文彙整五種常見實作路徑,從前端外掛到後端自製方法,可依專案架構挑選。
最省事的做法是後端只輸出時間戳,前端交由 jQuery 外掛處理,例如 smart-time-ago。後端不必關心顯示格式,前端也能隨時調整語句風格。
若使用 FreeMarker 模板,可以直接寫成巨集,把 datetime 傳進去即可。
<#macro timeline_dt datetime=.now>
<#assign ct = (.now?long - datetime?long) / 1000>
<#if ct gte 31104000><#--n 年前-->${(ct/31104000)?int}年前<#t>
<#elseif ct gte 2592000><#--n 月前-->${(ct/2592000)?int}個月前<#t>
<#elseif ct gte 86400*2><#--n 天前-->${(ct/86400)?int}天前<#t>
<#elseif ct gte 86400><#--1 天前-->昨天<#t>
<#elseif ct gte 3600><#--n 小時前-->${(ct/3600)?int}小時前<#t>
<#elseif ct gte 60><#--n 分鐘前-->${(ct/60)?int}分鐘前<#t>
<#elseif ct gt 0><#--n 秒前-->${ct?int}秒前<#t>
<#else>剛剛
</#if>
</#macro>
其他模板引擎可依相同思路類推,核心都是「先算出秒數差,再由大到小逐段比對」。
public static void main(String[] args) {
PrettyTime p = new PrettyTime();
System.out.println(p.format(DateUtils.addDays(new Date(), 2)));
}
現成的元件能處理多語言與過去/未來語態,不必自己維護規則。
private final static long minute = 60 * 1000; // 1 分鐘
private final static long hour = 60 * minute; // 1 小時
private final static long day = 24 * hour; // 1 天
private final static long month = 31 * day; // 月
private final static long year = 12 * month; // 年
/**
* 回傳文字描述的日期
* @param date 目標時間
* @return 相對時間描述
*/
public static String getTimeFormatText(Date date) {
if (date == null) {
return null;
}
long diff = new Date().getTime() - date.getTime();
long r = 0;
if (diff > year) { r = diff / year; return r + "年前"; }
if (diff > month) { r = diff / month; return r + "個月前"; }
if (diff > day) { r = diff / day; return r + "天前"; }
if (diff > hour) { r = diff / hour; return r + "個小時前"; }
if (diff > minute){ r = diff / minute;return r + "分鐘前"; }
return "剛剛";
}
這個版本邏輯清楚、無外部依賴,適合直接嵌進既有專案。缺點是閾值寫死,若日後要調整「多久算個月前」就得改程式碼。
原始版本 timeago.js 的核心是「讀取元素上的 datetime 屬性 → 與現在時間相減 → 依距離換算成文字 → 定時刷新」。使用方式很簡單:
<time class="timeago" datetime="2024-01-05T14:30:00Z">2024-01-05</time>
<script>
jQuery.timeago.settings.strings = {
suffixAgo: "前",
seconds: "1分鐘",
minute: "1分鐘",
minutes: "%d分鐘",
hour: "1小時",
hours: "%d小時",
day: "1天",
days: "%d天",
month: "1月",
months: "%d月",
year: "1年",
years: "%d年",
wordSeparator: ""
};
$("time.timeago").timeago();
</script>
中文化只要替換 settings.strings 這個映射即可,%d 會被替換成實際數字。它的另一個優點是內建「依時間距離調整刷新頻率」:一分鐘內的資料每分鐘更新一次,一小時內的每 22 分鐘更新,以此類推,避免不必要的定時器負擔。
不想引入外掛的話,其實一個函式就足夠:
function timeAgo(date) {
var seconds = Math.floor((new Date() - new Date(date)) / 1000);
var units = [
[31536000, "年"],
[2592000, "個月"],
[86400, "天"],
[3600, "小時"],
[60, "分鐘"],
[1, "秒"]
];
if (seconds < 5) return "剛剛";
for (var i = 0; i < units.length; i++) {
var interval = Math.floor(seconds / units[i][0]);
if (interval >= 1) {
return interval + " " + units[i][1] + "前";
}
}
}
console.log(timeAgo("2024-01-05T14:30:00Z"));
顯示位置在伺服器渲染的頁面,用方法二或方法四;需要「不重新整理也會自動更新」的即時感,用方法五的前端外掛;想要兩者兼顧,最乾淨的組合是後端輸出 datetime 屬性、前端用精簡版函式接手。無論選哪一種,記得在 HTML 上保留原始的絕對時間(例如放在 title 屬性),讓使用者滑過時還能看到精確時間,對無障礙與可讀性都有幫助。