方法命名约定

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

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

PrefixMethod TypeUse
ofstatic factory创建一个实例,其中工厂主要在验证 Importing 参数,而不转换它们。
fromstatic factory将 Importing 参数转换为目标类的实例,这可能涉及从 Importing 中丢失信息。
parsestatic factory解析 Importing 字符串 以生成目标类的实例。
formatinstance使用指定的格式化程序格式化时间对象中的值以产生字符串。
getinstance返回目标对象状态的一部分。
isinstance查询目标对象的状态。
withinstance返回更改了一个元素的目标对象的副本;这与 JavaBean 上的set方法是不变的。
plusinstance返回添加了一定时间的目标对象的副本。
minusinstance返回目标对象的副本,其中减去了一段时间。
toinstance将此对象转换为另一种类型。
atinstance将此对象与另一个对象合并。