文档

Java™ 教程-Java Tutorials 中文版
方法命名规范
Trail: Date Time
Lesson: Date-Time Overview

方法命名规范

Date-Time API 在丰富的类集中提供了丰富的方法。尽可能在类之间使方法名一致。例如,许多类提供了一个 now 方法,该方法捕获与该类相关的当前时刻的日期或时间值。有 from 的方法允许从一个类转换到另一个类。

关于方法名称前缀也有标准化。由于 Date-Time API 中的大多数类都是不可变的,因此 API 不包含 set 方法。(创建后,不能更改不可变对象的值。set 方法的不可变等价物是 with。)下表列出了常用的前缀:

前缀 方法类型 使用
of 静态工厂 创建一个实例,其中工厂主要验证输入参数,而不是转换它们。
from 静态工厂 将输入参数转换为目标类的实例,这可能涉及从输入中丢失信息。
parse 静态工厂 解析输入字符串以生成目标类的实例。
format 实例 使用指定的格式化程序格式化时间对象中的值以生成字符串。
get 实例 返回目标对象状态的一部分。
is 实例 查询目标对象的状态。
with 实例 返回目标对象的副本,其中一个元素已更改;这是 JavaBean 上 set 方法的不可变等价物。
plus 实例 返回目标对象的副本,并添加一定量的时间。
minus 实例 返回目标对象的副本,并减去一定的时间量。
to 实例 将此对象转换为另一种类型。
at 实例 将此对象与另一个对象组合。

Previous page: The Date-Time Packages
Next page: Standard Calendar