萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Java 取得日期時間年月日時分秒:Calendar 與 Java 8 新 API 完整對比

兩種時代的日期時間 API

特性舊 API (java.util.Calendar/Date)新 API (java.time, Java 8+)
設計可變、非執行緒安全、月份 0-based不可變、執行緒安全、月份 1-based
時區處理麻煩、易出錯內建 ZoneId、ZonedDateTime
解析/格式化SimpleDateFormat(非執行緒安全)DateTimeFormatter(執行緒安全)
推薦程度維護舊專案所有新專案

舊 API 實作(Calendar)

package com.date.demo;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;

public class DateDemo {
    
    /** 取得當前時間的年月日時分秒 */
    public static void getCurrentDateTime() {
        Calendar cal = Calendar.getInstance(); // 預設時區、預設 Locale
        
        int year       = cal.get(Calendar.YEAR);
        int month      = cal.get(Calendar.MONTH) + 1; // 月份 0-11,需 +1
        int day        = cal.get(Calendar.DAY_OF_MONTH);
        int hour       = cal.get(Calendar.HOUR_OF_DAY); // 24 小時制
        int minute     = cal.get(Calendar.MINUTE);
        int second     = cal.get(Calendar.SECOND);
        int millisecond = cal.get(Calendar.MILLISECOND);
        
        System.out.printf("現在時間:%04d-%02d-%02d %02d:%02d:%02d.%03d%n",
                year, month, day, hour, minute, second, millisecond);
    }
    
    /** 解析指定字串並取得各欄位 */
    public static void parseCustomDateTime(String dateStr, String pattern) {
        SimpleDateFormat sdf = new SimpleDateFormat(pattern);
        // SimpleDateFormat 非執行緒安全,區域變數使用無虞;共用需同步或 ThreadLocal
        
        Calendar cal = Calendar.getInstance();
        try {
            Date date = sdf.parse(dateStr);
            cal.setTime(date);
        } catch (ParseException e) {
            throw new IllegalArgumentException("日期格式錯誤:" + dateStr, e);
        }
        
        int year   = cal.get(Calendar.YEAR);
        int month  = cal.get(Calendar.MONTH) + 1;
        int day    = cal.get(Calendar.DAY_OF_MONTH);
        int hour   = cal.get(Calendar.HOUR_OF_DAY);
        int minute = cal.get(Calendar.MINUTE);
        int second = cal.get(Calendar.SECOND);
        
        System.out.printf("解析結果:%04d-%02d-%02d %02d:%02d:%02d%n",
                year, month, day, hour, minute, second);
    }
    
    public static void main(String[] args) {
        getCurrentDateTime();
        parseCustomDateTime("2013-11-10 18:45:39", "yyyy-MM-dd HH:mm:ss");
    }
}

新 API 實作(java.time)—— 強烈推薦

import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;

public class ModernDateTimeDemo {
    
    /** 當前時間各欄位 */
    public static void printNow() {
        LocalDateTime now = LocalDateTime.now(); // 本地時間,無時區
        
        int year   = now.getYear();
        int month  = now.getMonthValue(); // 1-12
        int day    = now.getDayOfMonth();
        int hour   = now.getHour();
        int minute = now.getMinute();
        int second = now.getSecond();
        int nano   = now.getNano();
        
        System.out.printf("現在:%04d-%02d-%02d %02d:%02d:%02d.%09d%n",
                year, month, day, hour, minute, second, nano);
        
        // 一次性取得多個欄位
        System.out.println("年:" + now.get(ChronoField.YEAR));
        System.out.println("季:" + now.get(ChronoField.QUARTER_OF_YEAR));
        System.out.println("週:" + now.get(ChronoField.ALIGNED_WEEK_OF_YEAR));
    }
    
    /** 解析字串 */
    public static void parseString(String str, String pattern) {
        DateTimeFormatter fmt = DateTimeFormatter.ofPattern(pattern);
        LocalDateTime dt = LocalDateTime.parse(str, fmt);
        
        System.out.println("年:" + dt.getYear());
        System.out.println("月:" + dt.getMonthValue());
        System.out.println("日:" + dt.getDayOfMonth());
    }
    
    /** 帶時區解析 */
    public static void parseWithZone(String str, String pattern, String zoneId) {
        DateTimeFormatter fmt = DateTimeFormatter.ofPattern(pattern);
        ZonedDateTime zdt = ZonedDateTime.parse(str, fmt.withZone(ZoneId.of(zoneId)));
        System.out.println("UTC 時間:" + zdt.toInstant());
    }
    
    /** 格式化輸出 */
    public static void formatOutput() {
        LocalDateTime now = LocalDateTime.now();
        DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH時mm分ss秒");
        System.out.println("中文格式:" + now.format(fmt));
    }
    
    public static void main(String[] args) {
        printNow();
        parseString("2013-11-10 18:45:39", "yyyy-MM-dd HH:mm:ss");
        formatOutput();
    }
}

常見操作對照表

操作Calendarjava.time
當前時間Calendar.getInstance()LocalDateTime.now()
指定日期建構cal.set(y, m-1, d, h, m, s)LocalDateTime.of(y, m, d, h, m, s)
取得年cal.get(Calendar.YEAR)dt.getYear() / dt.get(ChronoField.YEAR)
取得月cal.get(Calendar.MONTH)+1dt.getMonthValue() / dt.getMonth()
加減天數cal.add(Calendar.DAY, n)dt.plusDays(n) / dt.minusDays(n)
兩日期差天數(d2.getTime()-d1.getTime())/86400000ChronoUnit.DAYS.between(d1, d2)
格式化new SimpleDateFormat(pattern).format(date)dt.format(DateTimeFormatter.ofPattern(pattern))
解析sdf.parse(str)LocalDateTime.parse(str, formatter)

遷移建議

  1. 新專案直接使用 java.time
  2. 舊專案逐步替換:Date.toInstant() ↔ Date.from(instant) 橋接
  3. 資料庫層:JDBC 4.2+ 直接支援 LocalDateTime、LocalDate、Instant
  4. JSON 序列化:Jackson 需註冊 JavaTimeModule

總結

Calendar 雖仍可用,但設計缺陷明顯。Java 8 java.time 系列 API 解決了所有歷史包袱,語意清晰、執行緒安全、功能豐富。投資時間學習新 API,將在長期維護中獲得巨大回報。

copyright © 萬盛學電腦網 all rights reserved