文档

Java™教程
隐藏目录
方法命名约定
路径: 日期 时间
教程: 日期-时间概述

方法命名约定

日期时间 API 提供了丰富的方法和类。方法名在尽可能的情况下保持一致。例如,许多类都提供了一个 now 方法,用于捕获与该类相关的当前时刻的日期或时间值。还有一些 from 方法,允许从一种类转换为另一种类。

方法名前缀也是标准化的。由于日期时间 API 中的大多数类都是不可变的,API 不包括 set 方法。(创建后,不可变对象的值无法更改。不可变对象的等价方法是 with。)下表列出了常用的前缀:

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

上一页: 日期时间包
下一页: 标准日历