您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

DateTools 日期時間工具類全解析：週期計算、格式化、偏移、差值、閏年判斷

編輯：Java 綜合教學

核心功能一覽

支援 ISO (週日為週首) 與 GBK (週一為週首) 兩種週制
取得當前時間、任意格式化輸出
計算指定日期所在年份的第幾週、該週所有日期
依年份與週數取得該週日期陣列
判斷指定日期星期幾
計算指定年份總週數
兩日期差值 (毫秒/秒/分/時/天)
日期前後偏移 (分鐘/小時/月)
日期格式互轉 (String ↔ Date ↔ Long)
計算某年某月天數 (含閏年判斷)

關鍵方法簽名與說明

方法	參數	返回	說明
getDate(fmt)	格式字串	String	當前時間格式化
getWeekOfYear(date, fmt)	日期、格式	int	該日期屬於當年第幾週
getWeekDay(date, oldFmt, newFmt)	日期、輸入格式、輸出格式	String[7]	該日期所在週的 7 天日期陣列
getWeekDate(year, week, newFmt)	年份、週數、輸出格式	String[7]	指定年份第 N 週的 7 天日期
getDayOfWeek(date, oldFmt, fmt)	日期、輸入格式、輸出前綴	String	星期幾 (如 "週3")
getWeekNum(year)	年份字串	int	該年總週數
cntTimeDifference(s, e, fmt, refmt)	開始、結束、格式、差值單位	String	兩日期差值
getBeforeTime(date, fmt, min, newFmt)	日期、格式、分鐘偏移、輸出格式	String	日期向前/後偏移分鐘
fmtDate(date, oldFmt, newFmt)	日期、舊格式、新格式	String	日期格式轉換
getMonthDays(year, month)	年、月	int	該月天數

使用範例

DateTools dt = new DateTools(DateTools.WEEK_OF_GBK); // 週一為週首
System.out.println(dt.getDate("yyyy-MM-dd HH:mm:ss"));
System.out.println("本年第 " + dt.getWeekOfYear("2024-07-01", "yyyy-MM-dd") + " 週");
String[] week = dt.getWeekDay("2024-07-01", "yyyy-MM-dd", "MM/dd");
for (String d : week) System.out.print(d + " ");
System.out.println("\n2024 年第 1 週：" + Arrays.toString(dt.getWeekDate("2024", 1, "yyyy-MM-dd")));
System.out.println(dt.cntTimeDifference("2024-01-01", "2024-07-01", "yyyy-MM-dd", "d") + " 天");