Java教程是为JDK 8编写的。本页面描述的示例和实践不利用后续版本引入的改进,并可能使用不再可用的技术。
有关Java SE 9和后续版本中更新的语言功能的摘要,请参阅Java语言变更。
有关所有JDK版本的新功能、增强功能以及已删除或不推荐使用的选项的信息,请参阅JDK发布说明。
日期时间 API 提供了丰富的方法和类。方法名在尽可能的情况下保持一致。例如,许多类都提供了一个 now 方法,用于捕获与该类相关的当前时刻的日期或时间值。还有一些 from 方法,允许从一种类转换为另一种类。
方法名前缀也是标准化的。由于日期时间 API 中的大多数类都是不可变的,API 不包括 set 方法。(创建后,不可变对象的值无法更改。不可变对象的等价方法是 with。)下表列出了常用的前缀:
前缀 | 方法类型 | 用途 |
---|---|---|
of | 静态工厂 | 创建一个实例,其中工厂主要验证输入参数,而不是进行转换。 |
from | 静态工厂 | 将输入参数转换为目标类的实例,可能会丢失输入的信息。 |
parse | 静态工厂 | 解析输入的字符串以生成目标类的实例。 |
format | 实例 | 使用指定的格式化程序将时间对象中的值格式化为字符串。 |
get | 实例 | 返回目标对象的一部分状态。 |
is | 实例 | 查询目标对象的状态。 |
with | 实例 | 返回目标对象的副本,其中一个元素已更改;这是与 JavaBean 上的 set 方法等效的不可变方法。 |
plus | 实例 | 返回目标对象的副本,增加了一定的时间量。 |
minus | 实例 | 返回目标对象的副本,减去了一定的时间量。 |
to | 实例 | 将该对象转换为另一种类型。 |
at | 实例 | 将该对象与另一个对象结合。 |