Java 教程是为 JDK 8 编写的。本页中描述的示例和实践未利用在后续版本中引入的改进。
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 | 实例 | 将此对象与另一个对象组合。 |