DIV CSS 佈局教程網

fmt:formatDate 輸出格式全解析:type、dateStyle、timeStyle 與自訂 pattern
編輯:關於JavaScript     

JSTL 的 <fmt:formatDate> 靠三組屬性控制輸出:type 決定要日期、時間或兩者;dateStyle 與 timeStyle 決定長度;pattern 則是完全自訂。

type 屬性

<fmt:formatDate value="${isoDate}" type="both"/>  → 2004-5-31 23:59:59
<fmt:formatDate value="${date}" type="date"/>     → 2004-4-1
<fmt:formatDate value="${isoDate}" type="time"/>  → 23:59:59

dateStyle 屬性

default → 2004-5-31
short   → 04-5-31
medium  → 2004-5-31
long    → 2004年5月31日
full    → 2004年5月31日 星期一

timeStyle 屬性

default → 23:59:59
short   → 下午11:59
medium  → 23:59:59
long    → 下午11時59分59秒
full    → 下午11時59分59秒 CDT

實際輸出會受 <fmt:setLocale> 設定的地區影響,上表為中文環境下的結果。

pattern 自訂格式

<fmt:formatDate value="${date}" type="both"
pattern="EEEE, MMMM d, yyyy HH:mm:ss Z"/>
→ 星期四, 四月 1, 2004 13:30:00 -0600

<fmt:formatDate value="${isoDate}" type="both"
pattern="d MMM yy, h:m:s a zzzz"/>
→ 31 五月 04, 11:59:59 下午 中央夏令時

格式字元對照

d月中的某一天,一位數不補零
dd月中的某一天,一位數補前導零
ddd星期名稱縮寫
dddd星期名稱完整
M月份數字,一位數不補零
MM月份數字,一位數補前導零
MMM月份縮寫名稱
MMMM月份完整名稱
y / yy不含紀元的年份(yy 一位數時補零)
yyyy含紀元的四位數年份
gg時期或紀元
h / hh12 小時制(hh 補前導零)
H / HH24 小時制(HH 補前導零)
m / mm分鐘(mm 補前導零)
s / ss秒(ss 補前導零)
Z時區偏移量,如 -0600
a上午/下午標記

實務陷阱

H 與 h 在 0 點的結果不同。以下兩種寫法在午夜時段輸出會有差異:

<fmt:formatDate value="${xx}" pattern="dd/MM/yyyy HH:mm aa"/>
<fmt:formatDate value="${xx}" pattern="dd/MM/yyyy hh:mm aa"/>

HH 是 24 小時制,0 點顯示 00;hh 是 12 小時制,0 點顯示 12 並搭配 am。若搭配 aa 使用,通常該選 hh;若不需要上下午標記,用 HH 才不會出現 00 點的錯亂。

型別要求。value 必須是 java.util.Date。若拿到的其實是 String,就無法格式化,此時可在前端裁切:

<td align="center"><script>document.write("${l.inputDate}".substring(0, 10));</script></td>

完整頁面範例

<%@ page language="java" contentType="text/html; charset=gb18030"%>
<%@ taglib uri="https://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
<%@ taglib uri="https://java.sun.com/jsp/jstl/core" prefix="c" %>
<html>
<head>
<title>My JSP 'fmt.jsp' starting page</title>
</head>
<body>
<c:set var="salary" value="3540.2301"/>
<c:set var="total" value="56225.2301"/>
<fmt:setLocale value="en_US"/>
currency:<fmt:formatNumber value="${salary}" type="currency" currencyCode="USD"/><br>
percent:<fmt:formatNumber value="${salary/total}" type="percent" maxFractionDigits="4"/><br>
<hr>
<jsp:useBean id="now" class="java.util.Date"></jsp:useBean>
<fmt:setLocale value="zh_CN"/>
full--><fmt:formatDate value="${now}" type="both" dateStyle="full" timeStyle="full"/><br>
long--><fmt:formatDate value="${now}" type="both" dateStyle="long" timeStyle="long"/><br>
medium--><fmt:formatDate value="${now}" type="both" dateStyle="medium" timeStyle="medium"/><br>
default--><fmt:formatDate value="${now}" type="both" dateStyle="default" timeStyle="default"/><br>
short--><fmt:formatDate value="${now}" type="both" dateStyle="short" timeStyle="short"/><br>
</body>
</html>
今天是:<fmt:formatDate value="${now}" pattern="G yyyy年MM月dd日 E"/><br>
現在是:<fmt:formatDate value="${now}" pattern="a HH:mm:ss.S z"/>

輸出結果:

今天是:公元 2007年10月19日 星期五
現在是:下午 20:04:11.484 CST

parseDate:反向解析字串

要與格式化反向操作,用 <fmt:parseDate> 把字串轉回日期物件,注意輸入必須完全符合 pattern,否則會丟出例外:

<%@ taglib prefix="c" uri="https://java.sun.com/jstl/core" %>
<%@ taglib prefix="fmt" uri="https://java.sun.com/jstl/fmt" %>

<fmt:parseDate value="${param.date}" var="date" pattern="yyyy/MM/dd:HH:mm:ss">
<fmt:parseDate value="${param.isoDate}" var="isoDate" pattern="yyyyMMdd'T'HHmmss">

對應的輸入範例:

Date:    2004/04/01:13:30:00  → Thu Apr 01 13:30:00 CST 2004
isoDate: 20040531T235959      → Mon May 31 23:59:59 CDT 2004

原範例未做錯誤處理,正式環境建議搭配 var 與 parseDate 的例外處理,或在後端先驗證格式再傳入。

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