<i18n dev> Integrated: 8294226: Document missing UnsupportedTemporalTypeException
Gautham Krishnan
gkrishnan at openjdk.org
Tue Jun 24 14:56:35 UTC 2025
On Mon, 16 Jun 2025 16:36:43 GMT, Gautham Krishnan <gkrishnan at openjdk.org> wrote:
> Some methods in the java.time.chrono interfaces—ChronoLocalDate, ChronoLocalDateTime, and ChronoZonedDateTime—override methods from the java.time.temporal.Temporal interface that are documented to throw UnsupportedTemporalTypeException when given unsupported fields or units.
>
> These overridden methods include:
>
> with(TemporalField, long)
>
> plus(long, TemporalUnit)
>
> minus(long, TemporalUnit)
>
> However, their Javadoc in the chrono interfaces does not mention the possibility of this exception, resulting in incomplete or inconsistent documentation. This contrasts with the parent Temporal interface, which explicitly documents the exception.
This pull request has now been integrated.
Changeset: 54acadbe
Author: Gautham Krishnan <gkrishnan at openjdk.org>
Committer: Roger Riggs <rriggs at openjdk.org>
URL: https://git.openjdk.org/jdk/commit/54acadbe668f6feced6eb9c28bcf46d1b3986eec
Stats: 10 lines in 3 files changed: 8 ins; 0 del; 2 mod
8294226: Document missing UnsupportedTemporalTypeException
Reviewed-by: rriggs, naoto
-------------
PR: https://git.openjdk.org/jdk/pull/25836
More information about the i18n-dev
mailing list