# 方法命名约定

> 原文： [https://docs.oracle.com/javase/tutorial/datetime/overview/naming.html](https://docs.oracle.com/javase/tutorial/datetime/overview/naming.html)

Date-Time API 在丰富的类集中提供了丰富的方法。尽可能在类之间使方法名一致。例如，许多类提供`现在`方法，该方法捕获与该类相关的当前时刻的日期或时间值。来自方法的`允许从一个类转换到另一个类。`

关于方法名称前缀也有标准化。由于 Date-Time API 中的大多数类都是不可变的，因此 API 不包含 `set` 方法。 （在创建之后，不能更改不可变对象的值。 `set` 方法的不可变等价物是`和`。）下表列出了常用的前缀：

| 字首 | 方法类型 | 使用 |
| --- | --- | --- |
| 的 | 静电厂 | 创建一个实例，其中工厂主要验证输入参数，而不是转换它们。 |
| 来自的 | 静电厂 | 将输入参数转换为目标类的实例，这可能涉及从输入中丢失信息。 |
| `解析` | 静电厂 | 解析输入字符串以生成目标类的实例。 |
| `格式` | 例 | 使用指定的格式化程序格式化 temporal 对象中的值以生成字符串。 |
| `得到` | 例 | 返回目标对象状态的一部分。 |
| `是` | 例 | 查询目标对象的状态。 |
|  | 例 | 返回目标对象的副本，其中一个元素已更改;这是 JavaBean 上 `set` 方法的不可变等价物。 |
| `加` | 例 | 返回目标对象的副本，并添加一定量的时间。 |
| `减去` | 例 | 返回目标对象的副本，减去时间量。 |
| `至` | 例 | 将此对象转换为另一种类型。 |
|  | 例 | 将此对象与另一个对象组合。 |