JSP中日期的用法

在開發有關日歷的應用程序時，不規則的每月日期數、每周天數和周末的計算一直是個很費腦筋的問題。結果，日期和時間的編程經常令程序員新手畏縮不前。本文將演示在JSP應用程序中日期的用法，為讀者完成某些常見任務提供方便的參考。


目的



示例應用程序的目的是：

通過HTML表單把日期參數提交某個JSP頁來處理。
接收日期參數並創建Calendar對象。
采用Calendar對象找出提交的日期是一周的第幾天以及選中月份裡有多少工作日。
用用戶易於閱讀的顯示格式對日期格式化。

環境

示例程序代碼在Java Web服務器上接受測試，該服務器配置了JDK 1.31。示例寫得很標准，在Tomcat或者其他JSP Web服務器（JDK 1.2或者以後版本）上運行的效果幾乎完全一樣。

通過表單把日期傳遞給JSP頁

Date（日期）參數是用戶從3欄下拉列表中選出來的。用戶提交表單之後，這些參數即被傳送給處理頁面。

在進行日歷編程時不要忘了導入java.util.Calendar：
〈%@ page import="java.util.Calendar" %〉

處理頁面的第1個任務是接收以下日期參數值：Date、Month和Year。
int curDate = 1;
if(request.getParameter("curDate") != null)
{
curDate = Integer.parseInt(request.getParameter("curDate"));
}

注意頁面參數被轉換為int類型，馬上我們就知道為什麼要這麼做了。



Calendar對象

我們的目標是創建和設置一個Calendar對象，用它進行日期計算。為此，我們首先需要實例化一個Calendar對象。
Calendar cal = Calendar.getInstance();

Calendar.getInstance()返回一個代表當前日期和時間的Calendar對象。
cal.clear();
cal.set(curYear, curMonth , curDate);

clear()方法清空Calendar，這樣我們才可能給該對象分配我們自己的日期值並為將來的計算做好准備。注意這些參數的順序：首先是年，最後是日期。



從Calendar獲取信息

以下是一組Calendar字段：

日期
DATE, DAY_OF_MONTH, DAY_OF_WEEK, DAY_OF_YEAR

時間
HOUR_OF_DAY, MINUTE, MILLISECOND, SECOND

周
WEEK_OF_MONTH, WEEK_OF_YEAR

年
YEAR

以上這些字段都可以通過Calendar的get()方法進行訪問，結果返回一個整數。以下代碼示例顯示了以上過程。

一周內的日期
int dayOfWeek = cal.get(cal.DAY_OF_WEEK);
out.print("〈br〉Day of Week: " + dayOfWeek + " 〈br〉");

一月內的日期
int dayOfMonth = cal.get(cal.DAY_OF_MONTH);
out.print("〈br〉Day of Month: " + dayOfMonth + " 〈br〉");

定位特定的日期



為了找出一周內特定的某一天就必須訪問DAY_OF_WEEK字段。該字段包含了范圍從1到7的整數值，1代表星期一，2代表星期二，其余以次類推。
int dayOfWeek = cal.get(cal.DAY_OF_WEEK);

這裡有個向用戶顯示日期的好方法，那就是聲明一個包含一周內天數的數組。然後就可以很方便地顯示各個日期了。只要采用DAY_OF_WEEK整數訪問數組內的當前日期即可。
String[] weekdays = new String[]
{“”, "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"};
〈%=weekdays[cal.get(cal.DAY_OF_WEEK)]%〉

注意該數組的第1個元素為空。這是因為DAY_OF_WEEK字段值的范圍是從1到7，而數組元素的引用范圍則是從0到6。在數組開頭加一個空元素就可以保證DAY_OF_WEEK字段的值和數組引用相匹配了。



找出周末
為了找出某天是否正好是星期天或者星期六可以編寫以下代碼：
int day = cal.get(cal.DAY_OF_WEEK);
if(day == 6 || day == 7)
{
//執行與周末有關的操作
}



工作日

現在我們需要計算出某個月內的工作日天數。用戶輸入日期（參看index.jsp）之後把參數發送給處理頁面（參看display.jsp）。在處理頁面上，我們把Calendar對象設置為該月的第1天。
cal.clear();
cal.set(curYear, curMonth , 1);
int maxDays = cal.getActualMaximum(cal.DATE);
out.print("〈br〉Number of days in month: " + maxDays + "〈br〉");

我們還需要知道某個月內到底有多少天。getActualMaximum()方法返回一個整數值，該值就包含了每個月內的最多天數：2月是28天，3月是31天等等。在閏年的話2月的天數返回 29天。

一旦我們得到了每個月內的最多天數，我們就可以很方便地循環每月天數判斷是否是周末或者工作一日。我們用add()方法給Calendar遞增1，如程序清單A所示。



用SimpleDateFormat向用戶顯示日期

SimpleDateFormat處理顯示日期的最常用需求，它可以用來把日期轉換為特定的保存格式。你可以采用以下的導入指示符：
〈%@ page import="java.text.SimpleDateFormat" %〉

以下的代碼給用戶顯示日期：
SimpleDateFormat formatter = new SimpleDateFormat("dd/MMM/yyyy");
out.print("〈br〉" + formatter.format(cal.getTime()) );

SimpleDateFormat對象接受一個字符串作為其對象構造器，該字符串參數包含了用戶希望采用的顯示格式。這個格式字符串可以包含額外的格式字符串，比如空格（“ ”）、反斜線（ “/”）和破折號（“-”）。

表A列出了所有有效的（常用的）顯示格式。

表A

格式
示例

“dd/MMM/yyyy”
06/Mar/1974

"dd-MM-yyyy"
06-03-1974

"dd MMMMMMMMM yyyy"
06 March 1974

"EEEEEEEEE, MMMMMMMMM dd, yyyy"
Wednesday, March 06, 1974


有效的SimpleDateFormat顯示格式



表B是SimpleDateFormat參數的縮略語表。

表B

y
year

M
month in year

d
day in month

D
day in year

w
week in year

W
week in month

E
day in week


SimpleDateFormat參數


重用代碼--FormatTitle

在同一頁面上實施多種格式轉換有個簡單方法：在Declaration元素中是聲明FormatTitle方法，它接受兩個參數，一個引用Calendar對象，另一個返回格式。
〈%!
public String FormatTitle(Calendar fCal, String format)
{
SimpleDateFormat formatter = new SimpleDateFormat(format);
return (formatter.format(fCal.getTime() ));
}
%〉

為了顯示日期，我們調用FormatTitle()並為其傳遞Calendar和格式字符串參數。
〈%=FormatTitle(cal, “dd-MMM-yyyy”)%〉


小結

學完以上的簡單教程，相信你現在應該能用Calendar和SimpleDateFormat對象操作和顯示日期了。

add()和set()方法可以輕松配置Calendar，促使你可以為商業應用程序遍歷月份和年數。FormatTitle方法可以大大簡化給用戶顯示日期的任務，同樣的，它還簡化了把日期轉換為字符串的操作，而這一操作主要應用在數據庫和XML文檔的數據保存方面。