核心類速覽
| 類 | 套件 | 用途 |
| Calendar | java.util | 日期運算、欄位獲取、時區、語系敏感 |
| SimpleDateFormat | java.text | 日期⇄字串格式化/解析,非執行緒安全 |
| Date | java.util | 時間戳毫秒值,JDK 8+ 建議用 Instant |
| fmt:formatDate | JSTL fmt | 視圖層格式化,支援時區/語系,推薦 JSP 使用 |
JSP 中完整處理流程
1. 從請求參數構建 Calendar
<%@ page import="java.util.Calendar" %>
<%
int year = 2024, month = 2, day = 15; // 實際從 request.getParameter 取得
Calendar cal = Calendar.getInstance();
cal.clear(); // 清除預設時間欄位
cal.set(year, month - 1, day); // 月份 0-based
%>
2. 獲取常用日期資訊
<%
int dayOfWeek = cal.get(Calendar.DAY_OF_WEEK); // 1=Sunday ... 7=Saturday
int dayOfMonth = cal.get(Calendar.DAY_OF_MONTH);
int weekOfYear = cal.get(Calendar.WEEK_OF_YEAR);
int maxDays = cal.getActualMaximum(Calendar.DAY_OF_MONTH); // 本月總天數
%>
3. 判斷週末與計算工作日
<%
// 判斷週末
boolean isWeekend = (dayOfWeek == Calendar.SATURDAY || dayOfWeek == Calendar.SUNDAY);
// 計算本月工作日數
int workDays = 0;
Calendar temp = (Calendar) cal.clone();
temp.set(Calendar.DAY_OF_MONTH, 1);
for (int i = 0; i < maxDays; i++) {
int dow = temp.get(Calendar.DAY_OF_WEEK);
if (dow != Calendar.SATURDAY && dow != Calendar.SUNDAY) workDays++;
temp.add(Calendar.DAY_OF_MONTH, 1);
}
%>
4. 多種格式輸出
<%@ page import="java.text.SimpleDateFormat" %>
<%
SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy-MM-dd");
SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy年MM月dd日 EEEE", Locale.TRADITIONAL_CHINESE);
SimpleDateFormat sdf3 = new SimpleDateFormat("HH:mm:ss z");
%>
當前日期:<%= sdf1.format(cal.getTime()) %><br>
中文完整:<%= sdf2.format(cal.getTime()) %><br>
時間帶時區:<%= sdf3.format(cal.getTime()) %>
5. 可重用的格式化方法(宣告區)
<%!
public String formatDate(Calendar c, String pattern, Locale loc) {
if (c == null) return "";
SimpleDateFormat f = new SimpleDateFormat(pattern, loc);
return f.format(c.getTime());
}
%>
<%= formatDate(cal, "yyyy/MM/dd", Locale.TAIWAN) %>
JSTL fmt 標籤(推薦用於視圖層)
<%@ taglib prefix="fmt" uri="https://java.sun.com/jsp/jstl/fmt" %>
<fmt:formatDate value="${cal.time}" pattern="yyyy-MM-dd" timeZone="GMT+8" var="formatted"/>
${formatted}
<fmt:parseDate value="2024-03-15" pattern="yyyy-MM-dd" var="parsed"/>
${parsed} <!-- java.util.Date -->
常用模式字母對照表
| 字母 | 含義 | 範例 |
| y | 年 | 2024 |
| M | 月 | 03 / Mar / 三月 |
| d | 月內天數 | 15 |
| E | 星期 | 五 / 星期五 / Friday |
| H | 小時 (0-23) | 14 |
| h | 小時 (1-12) | 02 |
| m | 分鐘 | 05 |
| s | 秒 | 09 |
| S | 毫秒 | 123 |
| z | 時區名 | CST / GMT+08:00 |
JDK 8+ 現代化替代方案
<%@ page import="java.time.*, java.time.format.*" %>
<%
LocalDate date = LocalDate.of(2024, 3, 15);
LocalDateTime ldt = LocalDateTime.now();
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy年MM月dd日 EEEE", Locale.TRADITIONAL_CHINESE);
out.print(date.format(fmt));
// 執行緒安全、不可變、API 豐富
%>
新專案強烈建議遷移至 java.time 套件,僅維護舊系統時使用 Calendar/SimpleDateFormat。