Skip to content

程式語言 › Java › 核心 API

Java 核心 API (Core APIs) ​

標準函式庫中常用、但不屬於語法、OOP 或集合的幾個主題:日期時間 (java.time)、列舉 (enum)、Optional、遞迴。

日期與時間:java.time ​

Java 8+ 的 java.time 取代舊的 Date / Calendar:物件不可變、執行緒安全、日期與時間概念分開。

型別表示例子
LocalDate日期,沒有時間與時區生日、採檢日期
LocalTime時間,沒有日期營業時間
LocalDateTime日期 + 時間,沒有時區本地時間戳記
ZonedDateTime日期 + 時間 + 時區跨時區的會議時間
InstantUTC 時間軸上的一點log、資料庫時間戳記
Duration / Period時間長度(秒、奈秒)/ 日期長度(年月日)執行時間 / 年齡
java
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoUnit;

LocalDate today = LocalDate.now();
LocalDate d = LocalDate.parse("2024-03-10");                      // ISO 格式直接 parse
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("MM/dd/yyyy");
LocalDate us = LocalDate.parse("03/10/2024", fmt);                 // 自訂格式要給 formatter
String s = d.format(fmt);                                          // "03/10/2024"

d.plusDays(7);  d.minusMonths(1);  d.withDayOfMonth(1);            // 回傳新物件(不可變)
ChronoUnit.DAYS.between(d, today);                                 // 相差天數
Period.between(LocalDate.of(1990, 5, 1), today).getYears();        // 年齡

Instant t0 = Instant.now();
Duration elapsed = Duration.between(t0, Instant.now());
陷阱說明
格式不符parse 丟 DateTimeParseException
yyyy vs YYYY、MM vs mmYYYY 是週年(跨年那週會錯)、mm 是分鐘
用字串存日期再比較先 parse 成 LocalDate,才能安全比較與運算
LocalDateTime 用在跨時區資料存 Instant(UTC),顯示時再轉時區

Python / pandas 的對應操作見 Datetime。

列舉 (Enum) ​

定義一組固定、封閉的合法值,取代魔術字串或整數。

java
enum Status {
    PENDING("等待中"), RUNNING("執行中"), DONE("完成"), FAILED("失敗");

    private final String label;                 // enum 可以有欄位、建構子、方法
    Status(String label) { this.label = label; }
    public String label() { return label; }
    public boolean isTerminal() { return this == DONE || this == FAILED; }
}

Status s = Status.valueOf("RUNNING");           // 字串 → enum;不合法丟 IllegalArgumentException
for (Status st : Status.values()) {
    System.out.println(st + " " + st.ordinal() + " " + st.label());
}

String msg = switch (s) {                       // 搭配 switch:漏掉某個值時編譯器會提醒
    case PENDING, RUNNING -> "in progress";
    case DONE -> "ok";
    case FAILED -> "check logs";
};
好處說明
防止無效值只能是宣告過的常數
意圖明確Status.DONE 比 "done" 或 3 清楚
集中管理相關常數、標籤、行為放在一起

ordinal() 是宣告順序,插入新常數就會改變;不要存進資料庫或當商業邏輯,存 name()。

Optional ​

明確表示「可能沒有值」,取代回傳 null:

java
Optional<String> found = names.stream().filter(n -> n.startsWith("Z")).findFirst();
found.orElse("none");                          // 沒有值時的預設
found.ifPresent(System.out::println);
found.map(String::length).orElse(0);

只用在回傳值;不要用在欄位或方法參數。

遞迴 (Recursion) ​

方法呼叫自己來解較小的子問題;必須有基底情況 (base case) 讓呼叫停止。

java
static long factorial(int n) {
    if (n <= 1) return 1;            // 基底情況
    return n * factorial(n - 1);     // 遞迴情況:問題變小
}
適合不適合
結構自相似:樹、目錄、巢狀資料深度很大(JVM 預設堆疊約數千到上萬層,超過丟 StackOverflowError)
分治法:合併排序、二分搜尋子問題大量重疊卻沒記憶化(費氏數列的天真遞迴是指數時間)

演算法層面的說明見 排序演算法、圖走訪。