方法命名约定
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 | 将此对象与另一个对象合并。 |