網頁

2019/12/6

Java 8 日期時間API方法命名慣例 Date-Time method API naming convention

Java 8 日期時間API Package有統一的命名慣例,每種命名的用法及意義如下。

前綴名 方法類型 用途
of 靜態工廠方法 建立一個實例,工廠方法主要用來驗證輸入參數。
from 靜態工廠方法 轉換輸入參數為實例,過程中可能拆分並丟棄輸入參數的部分資訊。
parse 靜態工廠方法 解析輸入字串並產生實例。
format 實例方法 使用指定的formatter來轉換物件為格是化的字串。
get 實例方法 返回物件的部分狀態。
is 實例方法 查詢物件狀態。
with 實例方法 返回目標物件的複製品並修改一個屬性內容,相當於Java Bean的set方法的Immutable版本。
plus 實例方法 返回目標物件的複製品並加上時間。
minus 實例方法 返回目標物件的複製品並減去時間。
to 實例方法 轉換物件為另一種類別型態。
at 實例方法 與另一個物件結合。

例如在LocalDate即可看到以上命名慣例的方法。


Java 8的日期時間API為以下package中的各類別。


重點是工作中撰寫程式時可以使用這些命名慣例。



參考:

沒有留言:

張貼留言