方法命名约定

Date-Time API 在一组丰富的类中提供了一组丰富的方法。使方法名称在类之间尽可能保持一致。例如,许多类都提供now方法,该方法catch与该类相关的当前 Moment 的日期或时间值。有from个方法可以从一个类转换为另一个类。

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

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