From 4635586a6702b09de03a7ecbe662784a7ae96a5c Mon Sep 17 00:00:00 2001
From: Scala Steward The four supported eras are hard-coded. A single additional era
- * may be registered using {@link #registerEra(LocalDate, String)}.
+ * may be registered using {@link #registerEra(LocalDate, String)} .
*
* A new Japanese era can begin at
+ * Registers an additional instance of {@code JapaneseEra} . A new Japanese era can begin at
* any time. This method allows one new era to be registered without the need for a new library
* version. If needed, callers should assign the result to a static variable accessible across the
* application. This must be done once, in early startup code. NOTE: This method does not
@@ -19,7 +19,7 @@ object TTBPJapaneseEra {
* @param name
* the name
* @return
- * the { @code JapaneseEra} singleton, not null
+ * the {@code JapaneseEra} singleton, not null
* @throws DateTimeException
* if an additional era has already been registered
*/
diff --git a/core/native/src/main/scala/java/util/SimpleTimeZone.scala b/core/native/src/main/scala/java/util/SimpleTimeZone.scala
index a67b120b5..e85193b6d 100644
--- a/core/native/src/main/scala/java/util/SimpleTimeZone.scala
+++ b/core/native/src/main/scala/java/util/SimpleTimeZone.scala
@@ -1,9 +1,9 @@
package java.util
class SimpleTimeZone(rawOffset: Int, var ID: String) extends TimeZone {
- override def getRawOffset = rawOffset
+ override def getRawOffset = rawOffset
/* concrete methods */
- override def getID: String = ID
+ override def getID: String = ID
override def setID(id: String): Unit = ID = id
}
diff --git a/core/native/src/main/scala/java/util/TimeZone.scala b/core/native/src/main/scala/java/util/TimeZone.scala
index 5d172d48e..8dd3cdcc1 100644
--- a/core/native/src/main/scala/java/util/TimeZone.scala
+++ b/core/native/src/main/scala/java/util/TimeZone.scala
@@ -13,11 +13,11 @@ object TimeZone {
// TODO: implement this functionality, perhaps using https://github.com/scala-native/scala-native/blob/master/posixlib/src/main/scala/scala/scalanative/posix/time.scala
new SimpleTimeZone(0, "UTC")
- def getDefault: TimeZone = default
+ def getDefault: TimeZone = default
def setDefault(timeZone: TimeZone): Unit = default = timeZone
def getTimeZone(timeZone: String): TimeZone = getTimeZone(ZoneId.of(timeZone))
- def getTimeZone(zoneId: ZoneId): TimeZone = {
+ def getTimeZone(zoneId: ZoneId): TimeZone = {
val rules = zoneId.getRules
val offsetInMillis = rules.getStandardOffset(Instant.now).getTotalSeconds * 1000
new SimpleTimeZone(offsetInMillis, zoneId.getId)
@@ -42,7 +42,7 @@ abstract class TimeZone extends Serializable with Cloneable {
// def useDaylightTime: Boolean
/* concrete methods */
- def getID: String = ID
+ def getID: String = ID
def setID(id: String): Unit = ID = id
def getDisplayName(daylight: Boolean, style: Int, locale: Locale): String = {
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/DayOfWeek.scala b/core/shared/src/main/scala-2/org/threeten/bp/DayOfWeek.scala
index c77d2bf23..2e427a426 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/DayOfWeek.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/DayOfWeek.scala
@@ -60,7 +60,7 @@ import org.threeten.bp.temporal.ValueRange
* assign different numeric values to the days, declaring Sunday to have the value 1, however this
* class provides no support for this. See {@link WeekFields} for localized week-numbering.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code DayOfWeek}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code DayOfWeek} . Use
* {@code getValue()} instead.
*
* This enum represents a common concept that is found in many calendar systems. As such, this enum
@@ -72,12 +72,13 @@ import org.threeten.bp.temporal.ValueRange
object DayOfWeek {
/**
- * The singleton instance for the day-of-week of Monday. This has the numeric value of {@code 1}.
+ * The singleton instance for the day-of-week of Monday. This has the numeric value of {@code 1} .
*/
lazy val MONDAY = new DayOfWeek("MONDAY", 0)
/**
- * The singleton instance for the day-of-week of Tuesday. This has the numeric value of {@code 2}.
+ * The singleton instance for the day-of-week of Tuesday. This has the numeric value of {@code 2}
+ * .
*/
lazy val TUESDAY = new DayOfWeek("TUESDAY", 1)
@@ -94,7 +95,7 @@ object DayOfWeek {
lazy val THURSDAY = new DayOfWeek("THURSDAY", 3)
/**
- * The singleton instance for the day-of-week of Friday. This has the numeric value of {@code 5}.
+ * The singleton instance for the day-of-week of Friday. This has the numeric value of {@code 5} .
*/
lazy val FRIDAY = new DayOfWeek("FRIDAY", 4)
@@ -105,7 +106,7 @@ object DayOfWeek {
lazy val SATURDAY = new DayOfWeek("SATURDAY", 5)
/**
- * The singleton instance for the day-of-week of Sunday. This has the numeric value of {@code 7}.
+ * The singleton instance for the day-of-week of Sunday. This has the numeric value of {@code 7} .
*/
lazy val SUNDAY = new DayOfWeek("SUNDAY", 6)
@@ -147,19 +148,19 @@ object DayOfWeek {
* Obtains an instance of {@code DayOfWeek} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code DayOfWeek}.
+ * converts the arbitrary temporal object to an instance of {@code DayOfWeek} .
*
* The conversion extracts the {@link ChronoField#DAY_OF_WEEK DAY_OF_WEEK} field.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used as a query via method reference, {@code DayOfWeek::from}.
+ * to be used as a query via method reference, {@code DayOfWeek::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the day-of-week, not null
* @throws DateTimeException
- * if unable to convert to a { @code DayOfWeek}
+ * if unable to convert to a {@code DayOfWeek}
*/
def from(temporal: TemporalAccessor): DayOfWeek = {
temporal match {
@@ -221,7 +222,7 @@ final class DayOfWeek(name: String, ordinal: Int)
* If the field is {@link ChronoField#DAY_OF_WEEK DAY_OF_WEEK} then this method returns true. All
* other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -247,7 +248,7 @@ final class DayOfWeek(name: String, ordinal: Int)
* from 1 to 7, will be returned. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -267,7 +268,7 @@ final class DayOfWeek(name: String, ordinal: Int)
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this day-of-week as an {@code int}.
+ * Gets the value of the specified field from this day-of-week as an {@code int} .
*
* This queries this day-of-week for the value for the specified field. The returned value will
* always be within the valid range of values for the field. If it is not possible to return the
@@ -277,7 +278,7 @@ final class DayOfWeek(name: String, ordinal: Int)
* from 1 to 7, will be returned. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -288,7 +289,7 @@ final class DayOfWeek(name: String, ordinal: Int)
* @throws DateTimeException
* if a value for the field cannot be obtained
* @throws DateTimeException
- * if the range of valid values for the field exceeds an { @code int}
+ * if the range of valid values for the field exceeds an {@code int}
* @throws DateTimeException
* if the value is outside the range of valid values for the field
* @throws ArithmeticException
@@ -301,7 +302,7 @@ final class DayOfWeek(name: String, ordinal: Int)
range(field).checkValidIntValue(getLong(field), field)
/**
- * Gets the value of the specified field from this day-of-week as a {@code long}.
+ * Gets the value of the specified field from this day-of-week as a {@code long} .
*
* This queries this day-of-week for the value for the specified field. If it is not possible to
* return the value, because the field is not supported or for some other reason, an exception is
@@ -311,7 +312,7 @@ final class DayOfWeek(name: String, ordinal: Int)
* from 1 to 7, will be returned. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -406,7 +407,7 @@ final class DayOfWeek(name: String, ordinal: Int)
* The adjustment is equivalent to using {@link Temporal#with(TemporalField, long)} passing {@link
* ChronoField#DAY_OF_WEEK} as the field. Note that this adjusts forwards or backwards within a
* Monday to Sunday week. See {@link WeekFields#dayOfWeek} for localized week start days. See
- * {@link TemporalAdjusters} for other adjusters with more control, such as {@code next(MONDAY)}.
+ * {@link TemporalAdjusters} for other adjusters with more control, such as {@code next(MONDAY)} .
*
* In most cases, it is clearer to reverse the calling pattern by using {@link
* Temporal#with(TemporalAdjuster)}: Note that ± means either the plus or minus symbol.
@@ -234,20 +234,20 @@ object ZoneOffset {
* Obtains an instance of {@code ZoneOffset} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code ZoneOffset}.
+ * converts the arbitrary temporal object to an instance of {@code ZoneOffset} .
*
* The conversion uses the {@link TemporalQueries#offset()} query, which relies on extracting the
* {@link ChronoField#OFFSET_SECONDS OFFSET_SECONDS} field.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code ZoneOffset::from}.
+ * to be used in queries via method reference, {@code ZoneOffset::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the zone-offset, not null
* @throws DateTimeException
- * if unable to convert to an { @code ZoneOffset}
+ * if unable to convert to an {@code ZoneOffset}
*/
def from(temporal: TemporalAccessor): ZoneOffset = {
val offset: ZoneOffset = temporal.query(TemporalQueries.offset)
@@ -322,7 +322,7 @@ object ZoneOffset {
/**
* Obtains an instance of {@code ZoneOffset} specifying the total offset in seconds
*
- * The offset must be in the range {@code -18:00} to {@code +18:00}, which corresponds to -64800
+ * The offset must be in the range {@code -18:00} to {@code +18:00} , which corresponds to -64800
* to +64800.
*
* @param totalSeconds
@@ -371,7 +371,7 @@ object ZoneOffset {
}
/**
- * A time-zone offset from Greenwich/UTC, such as {@code +02:00}.
+ * A time-zone offset from Greenwich/UTC, such as {@code +02:00} .
*
* A time-zone offset is the period of time that a time-zone differs from Greenwich/UTC. This is
* usually a fixed number of hours and minutes.
@@ -392,7 +392,7 @@ object ZoneOffset {
* class may be used with other calendar systems providing the definition of the time fields matches
* those of the ISO calendar system.
*
- * Instances of {@code ZoneOffset} must be compared using {@link #equals}. Implementations may
+ * Instances of {@code ZoneOffset} must be compared using {@link #equals} . Implementations may
* choose to cache certain common offsets, however applications must not rely on such caching.
*
* This approach treats the
* problem of globalized calendar systems as a localization issue and confines it to the UI layer.
@@ -271,10 +271,10 @@ trait ChronoLocalDate extends Temporal with TemporalAdjuster with Ordered[Chrono
*
* The era is, conceptually, the largest division of the time-line. Most calendar systems have a
* single epoch dividing the time-line into two eras. However, some have multiple eras, such as
- * one for the reign of each leader. The exact meaning is determined by the {@code Chronology}.
+ * one for the reign of each leader. The exact meaning is determined by the {@code Chronology} .
*
* All correctly implemented {@code Era} classes are singletons, thus it is valid code to write
- * {@code date.getEra() == SomeEra.NAME)}.
+ * {@code date.getEra() == SomeEra.NAME)} .
*
* @return
* the chronology specific era constant applicable at this date, not null
@@ -288,7 +288,7 @@ trait ChronoLocalDate extends Temporal with TemporalAdjuster with Ordered[Chrono
* chronology with the constraint that a leap-year must imply a year-length longer than a non
* leap-year.
*
- * The default implementation uses {@link Chronology#isLeapYear(long)}.
+ * The default implementation uses {@link Chronology#isLeapYear(long)} .
*
* @return
* true if this date is in a leap year, false otherwise
@@ -355,7 +355,7 @@ trait ChronoLocalDate extends Temporal with TemporalAdjuster with Ordered[Chrono
def adjustInto(temporal: Temporal): Temporal = temporal.`with`(EPOCH_DAY, toEpochDay)
/**
- * Calculates the period between this date and another date as a {@code ChronoPeriod}.
+ * Calculates the period between this date and another date as a {@code ChronoPeriod} .
*
* This calculates the period between two dates. All supplied chronologies calculate the period
* using years, months and days, however the {@code ChronoPeriod} API allows the period to be
@@ -401,7 +401,7 @@ trait ChronoLocalDate extends Temporal with TemporalAdjuster with Ordered[Chrono
}
/**
- * Combines this date with a time to create a {@code ChronoLocalDateTime}.
+ * Combines this date with a time to create a {@code ChronoLocalDateTime} .
*
* This returns a {@code ChronoLocalDateTime} formed from this date at the specified time. All
* possible combinations of date and time are valid.
@@ -430,7 +430,7 @@ trait ChronoLocalDate extends Temporal with TemporalAdjuster with Ordered[Chrono
* Compares this date to another date, including the chronology.
*
* The comparison is based first on the underlying time-line date, then on the chronology. It is
- * "consistent with equals", as defined by {@link Comparable}.
+ * "consistent with equals", as defined by {@link Comparable} .
*
* For example, the following is the comparator order: Specification for implementors
This class is immutable and thread-safe.
*
* @constructor
- * Constructs a {@code JapaneseDate}.
+ * Constructs a {@code JapaneseDate} .
*
* This constructor does NOT validate the given parameters, and {@code era} and {@code year} must
- * agree with {@code isoDate}.
+ * agree with {@code isoDate} .
* @param era
* the era, validated not null
* @param yearOfEra
@@ -307,7 +307,7 @@ final class JapaneseDate private[chrono] (
* Specification for implementors
This class is immutable and thread-safe.
*
@@ -213,7 +213,7 @@ final class JapaneseEra private[chrono] (
}
/**
- * Returns the numeric value of this {@code JapaneseEra}.
+ * Returns the numeric value of this {@code JapaneseEra} .
*
* The {@link #SHOWA} era that contains 1970-01-01 (ISO calendar system) has the value 1. Later
* eras are numbered from 2 ({@link #HEISEI}). Earlier eras are numbered 0 ({@link #TAISHO}) and
diff --git a/core/jvm/src/main/scala/org/threeten/bp/chrono/internal/TTBPJapaneseEra.scala b/core/jvm/src/main/scala/org/threeten/bp/chrono/internal/TTBPJapaneseEra.scala
index 0506f526b..0ab0ea550 100644
--- a/core/jvm/src/main/scala/org/threeten/bp/chrono/internal/TTBPJapaneseEra.scala
+++ b/core/jvm/src/main/scala/org/threeten/bp/chrono/internal/TTBPJapaneseEra.scala
@@ -8,7 +8,7 @@ import java.util.Arrays
object TTBPJapaneseEra {
/**
- * Registers an additional instance of {@code JapaneseEra}. // these two lines are equivalent, but the second
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/Month.scala b/core/shared/src/main/scala-2/org/threeten/bp/Month.scala
index f6a778cf7..2655da578 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/Month.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/Month.scala
@@ -60,8 +60,8 @@ import org.threeten.bp.temporal.ValueRange
* is recommended that applications use the enum rather than the {@code int} value to ensure code
* clarity.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code Month}. Use {@code
- * getValue()} instead.
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code Month} . Use
+ * {@code getValue()} instead.
*
* This enum represents a common concept that is found in many calendar systems. As such, this enum
* may be used by any calendar system that has the month-of-year concept defined exactly equivalent
@@ -73,25 +73,25 @@ object Month {
/**
* The singleton instance for the month of January with 31 days. This has the numeric value of
- * {@code 1}.
+ * {@code 1} .
*/
lazy val JANUARY = new Month("JANUARY", 0)
/**
* The singleton instance for the month of February with 28 days, or 29 in a leap year. This has
- * the numeric value of {@code 2}.
+ * the numeric value of {@code 2} .
*/
lazy val FEBRUARY = new Month("FEBRUARY", 1)
/**
* The singleton instance for the month of March with 31 days. This has the numeric value of
- * {@code 3}.
+ * {@code 3} .
*/
lazy val MARCH = new Month("MARCH", 2)
/**
* The singleton instance for the month of April with 30 days. This has the numeric value of
- * {@code 4}.
+ * {@code 4} .
*/
lazy val APRIL = new Month("APRIL", 3)
@@ -115,31 +115,31 @@ object Month {
/**
* The singleton instance for the month of August with 31 days. This has the numeric value of
- * {@code 8}.
+ * {@code 8} .
*/
lazy val AUGUST = new Month("AUGUST", 7)
/**
* The singleton instance for the month of September with 30 days. This has the numeric value of
- * {@code 9}.
+ * {@code 9} .
*/
lazy val SEPTEMBER = new Month("SEPTEMBER", 8)
/**
* The singleton instance for the month of October with 31 days. This has the numeric value of
- * {@code 10}.
+ * {@code 10} .
*/
lazy val OCTOBER = new Month("OCTOBER", 9)
/**
* The singleton instance for the month of November with 30 days. This has the numeric value of
- * {@code 11}.
+ * {@code 11} .
*/
lazy val NOVEMBER = new Month("NOVEMBER", 10)
/**
* The singleton instance for the month of December with 31 days. This has the numeric value of
- * {@code 12}.
+ * {@code 12} .
*/
lazy val DECEMBER = new Month("DECEMBER", 11)
@@ -191,21 +191,21 @@ object Month {
* Obtains an instance of {@code Month} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code Month}.
+ * converts the arbitrary temporal object to an instance of {@code Month} .
*
* The conversion extracts the {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} field. The
* extraction is only permitted if the temporal object has an ISO chronology, or can be converted
- * to a {@code LocalDate}.
+ * to a {@code LocalDate} .
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code Month::from}.
+ * to be used in queries via method reference, {@code Month::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the month-of-year, not null
* @throws DateTimeException
- * if unable to convert to a { @code Month}
+ * if unable to convert to a {@code Month}
*/
def from(temporal: TemporalAccessor): Month = {
var _temporal = temporal
@@ -271,7 +271,7 @@ final class Month private (name: String, ordinal: Int)
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then this method returns true.
* All other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -295,9 +295,9 @@ final class Month private (name: String, ordinal: Int)
*
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then the range of the
* month-of-year, from 1 to 12, will be returned. All other {@code ChronoField} instances will
- * throw a {@code DateTimeException}.
+ * throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -317,7 +317,7 @@ final class Month private (name: String, ordinal: Int)
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this month-of-year as an {@code int}.
+ * Gets the value of the specified field from this month-of-year as an {@code int} .
*
* This queries this month for the value for the specified field. The returned value will always
* be within the valid range of values for the field. If it is not possible to return the value,
@@ -325,9 +325,9 @@ final class Month private (name: String, ordinal: Int)
*
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then the value of the
* month-of-year, from 1 to 12, will be returned. All other {@code ChronoField} instances will
- * throw a {@code DateTimeException}.
+ * throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -338,7 +338,7 @@ final class Month private (name: String, ordinal: Int)
* @throws DateTimeException
* if a value for the field cannot be obtained
* @throws DateTimeException
- * if the range of valid values for the field exceeds an { @code int}
+ * if the range of valid values for the field exceeds an {@code int}
* @throws DateTimeException
* if the value is outside the range of valid values for the field
* @throws ArithmeticException
@@ -351,16 +351,16 @@ final class Month private (name: String, ordinal: Int)
range(field).checkValidIntValue(getLong(field), field)
/**
- * Gets the value of the specified field from this month-of-year as a {@code long}.
+ * Gets the value of the specified field from this month-of-year as a {@code long} .
*
* This queries this month for the value for the specified field. If it is not possible to return
* the value, because the field is not supported or for some other reason, an exception is thrown.
*
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then the value of the
* month-of-year, from 1 to 12, will be returned. All other {@code ChronoField} instances will
- * throw a {@code DateTimeException}.
+ * throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/chrono/HijrahEra.scala b/core/shared/src/main/scala-2/org/threeten/bp/chrono/HijrahEra.scala
index 12c9e0686..4516174f2 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/chrono/HijrahEra.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/chrono/HijrahEra.scala
@@ -79,7 +79,7 @@ object HijrahEra {
* The Hijrah calendar system has two eras. The date {@code 0001-01-01 (Hijrah)} is {@code 622-06-19
* (ISO)}.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code HijrahEra}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code HijrahEra} . Use
* {@code getValue()} instead.
*
*
*
* This method only considers the position of the two dates on the local time-line. It does not
* take into account the chronology, or calendar system. This is different from the comparison in
- * {@link #compareTo(ChronoLocalDate)} but is the same approach as {@link #DATE_COMPARATOR}.
+ * {@link #compareTo(ChronoLocalDate)} but is the same approach as {@link #DATE_COMPARATOR} .
*
* @param other
* the other date to compare to, not null
@@ -1690,9 +1687,9 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
}
/**
- * Outputs this date as a {@code String}, such as {@code 2007-12-03}.
+ * Outputs this date as a {@code String} , such as {@code 2007-12-03} .
*
- * The output will be in the ISO-8601 format {@code yyyy-MM-dd}.
+ * The output will be in the ISO-8601 format {@code yyyy-MM-dd} .
*
* @return
* a string representation of this date, not null
diff --git a/core/shared/src/main/scala/org/threeten/bp/LocalDateTime.scala b/core/shared/src/main/scala/org/threeten/bp/LocalDateTime.scala
index 8dfff04e3..b8d932052 100644
--- a/core/shared/src/main/scala/org/threeten/bp/LocalDateTime.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/LocalDateTime.scala
@@ -63,16 +63,16 @@ import org.threeten.bp.zone.ZoneRules
object LocalDateTime {
/**
- * The minimum supported {@code LocalDateTime}, '-999999999-01-01T00:00:00'. This is the local
+ * The minimum supported {@code LocalDateTime} , '-999999999-01-01T00:00:00'. This is the local
* date-time of midnight at the start of the minimum date. This combines {@link LocalDate#MIN} and
- * {@link LocalTime#MIN}. This could be used by an application as a "far past" date-time.
+ * {@link LocalTime#MIN} . This could be used by an application as a "far past" date-time.
*/
lazy val MIN: LocalDateTime = LocalDateTime.of(LocalDate.MIN, LocalTime.MIN)
/**
- * The maximum supported {@code LocalDateTime}, '+999999999-12-31T23:59:59.999999999'. This is the
- * local date-time just before midnight at the end of the maximum date. This combines {@link
- * LocalDate#MAX} and {@link LocalTime#MAX}. This could be used by an application as a "far
+ * The maximum supported {@code LocalDateTime} , '+999999999-12-31T23:59:59.999999999'. This is
+ * the local date-time just before midnight at the end of the maximum date. This combines {@link
+ * LocalDate#MAX} and {@link LocalTime#MAX} . This could be used by an application as a "far
* future" date-time.
*/
lazy val MAX: LocalDateTime = LocalDateTime.of(LocalDate.MAX, LocalTime.MAX)
@@ -420,19 +420,19 @@ object LocalDateTime {
* Obtains an instance of {@code LocalDateTime} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code LocalDateTime}.
+ * converts the arbitrary temporal object to an instance of {@code LocalDateTime} .
*
- * The conversion extracts and combines {@code LocalDate} and {@code LocalTime}.
+ * The conversion extracts and combines {@code LocalDate} and {@code LocalTime} .
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used as a query via method reference, {@code LocalDateTime::from}.
+ * to be used as a query via method reference, {@code LocalDateTime::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the local date-time, not null
* @throws DateTimeException
- * if unable to convert to a { @code LocalDateTime}
+ * if unable to convert to a {@code LocalDateTime}
*/
def from(temporal: TemporalAccessor): LocalDateTime =
temporal match {
@@ -563,7 +563,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* Specification for implementors
This is an immutable and thread-safe enum.
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/chrono/IsoEra.scala b/core/shared/src/main/scala-2/org/threeten/bp/chrono/IsoEra.scala
index 985490945..f9fe63392 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/chrono/IsoEra.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/chrono/IsoEra.scala
@@ -38,14 +38,14 @@ object IsoEra {
/**
* The singleton instance for the era BCE, 'Before Current Era'. The 'ISO' part of the name
* emphasizes that this differs from the BCE era in the Gregorian calendar system. This has the
- * numeric value of {@code 0}.
+ * numeric value of {@code 0} .
*/
lazy val BCE = new IsoEra("BCE", 0)
/**
* The singleton instance for the era CE, 'Current Era'. The 'ISO' part of the name emphasizes
* that this differs from the CE era in the Gregorian calendar system. This has the numeric value
- * of {@code 1}.
+ * of {@code 1} .
*/
lazy val CE = new IsoEra("CE", 1)
@@ -79,7 +79,7 @@ object IsoEra {
* - 'Current era' (CE) for years from 0001-01-01 (ISO) and 'Before current era' (BCE) for years
* before that.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code IsoEra}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code IsoEra} . Use
* {@code getValue()} instead.
*
* Specification for implementors
This is an immutable and thread-safe enum.
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/chrono/MinguoEra.scala b/core/shared/src/main/scala-2/org/threeten/bp/chrono/MinguoEra.scala
index 6014854ba..91dfae9b1 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/chrono/MinguoEra.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/chrono/MinguoEra.scala
@@ -37,13 +37,13 @@ object MinguoEra {
/**
* The singleton instance for the era BEFORE_ROC, 'Before Republic of China'. This has the numeric
- * value of {@code 0}.
+ * value of {@code 0} .
*/
lazy val BEFORE_ROC = new MinguoEra("BEFORE_ROC", 0)
/**
* The singleton instance for the era ROC, 'Republic of China'. This has the numeric value of
- * {@code 1}.
+ * {@code 1} .
*/
lazy val ROC = new MinguoEra("ROC", 1)
@@ -77,7 +77,7 @@ object MinguoEra {
* The Minguo calendar system has two eras. The date {@code 0001-01-01 (Minguo)} is equal to {@code
* 1912-01-01 (ISO)}.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code MinguoEra}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code MinguoEra} . Use
* {@code getValue()} instead.
*
* Specification for implementors
This is an immutable and thread-safe enum.
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala b/core/shared/src/main/scala-2/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala
index 77d3e484f..9dc1b0484 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala
@@ -282,8 +282,8 @@ object TTBPDateTimeFormatterBuilder {
* @param signStyle
* the positive/negative sign style, not null
* @param subsequentWidth
- * the width of subsequent non-negative numbers, 0 or greater,
- * -1 if fixed width due to active adjacent parsing
+ * the width of subsequent non-negative numbers, 0 or greater, -1 if fixed width due to active
+ * adjacent parsing
*/
private[format] class NumberPrinterParser private[format] (
private[format] val field: TemporalField,
@@ -797,8 +797,8 @@ object TTBPDateTimeFormatterBuilder {
*
* The fractional value must be between 0 (inclusive) and 1 (exclusive). It can only be returned
* if the {@link TemporalField#range() value range} is fixed. The value is obtained by
- * calculation from the field range and a rounding mode of {@link RoundingMode#FLOOR FLOOR}. The
- * calculation is inaccurate if the values do not run continuously from smallest to largest.
+ * calculation from the field range and a rounding mode of {@link RoundingMode#FLOOR FLOOR} .
+ * The calculation is inaccurate if the values do not run continuously from smallest to largest.
*
* For example, the fractional second-of-minute of 0.25 would be converted to 15, assuming the
* standard definition of 60 seconds in a minute.
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoField.scala b/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoField.scala
index d460583d4..feb7e462a 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoField.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoField.scala
@@ -52,7 +52,7 @@ import org.threeten.bp.format.ResolverStyle
* A standard set of fields.
*
* This set of fields provide field-based access to manipulate a date, time or date-time. The
- * standard set of fields can be extended by implementing {@link TemporalField}.
+ * standard set of fields can be extended by implementing {@link TemporalField} .
*
* These fields are intended to be applicable in multiple calendar systems. For example, most
* non-ISO calendar systems define dates as a year, month and day, just with slightly different
@@ -70,7 +70,7 @@ object ChronoField {
*
* This field is used to represent the nano-of-second handling any fraction of the second.
* Implementations of {@code TemporalAccessor} should provide a value for this field if they can
- * return a value for {@link #SECOND_OF_MINUTE}, {@link #SECOND_OF_DAY} or {@link
+ * return a value for {@link #SECOND_OF_MINUTE} , {@link #SECOND_OF_DAY} or {@link
* #INSTANT_SECONDS} filling unknown precision with zero.
*
* When this field is used for setting a value, it should set as much precision as the object
@@ -102,7 +102,7 @@ object ChronoField {
*
* This field is used to represent the micro-of-second handling any fraction of the second.
* Implementations of {@code TemporalAccessor} should provide a value for this field if they can
- * return a value for {@link #SECOND_OF_MINUTE}, {@link #SECOND_OF_DAY} or {@link
+ * return a value for {@link #SECOND_OF_MINUTE} , {@link #SECOND_OF_DAY} or {@link
* #INSTANT_SECONDS} filling unknown precision with zero.
*
* When this field is used for setting a value, it should behave in the same way as setting {@link
@@ -135,7 +135,7 @@ object ChronoField {
*
* This field is used to represent the milli-of-second handling any fraction of the second.
* Implementations of {@code TemporalAccessor} should provide a value for this field if they can
- * return a value for {@link #SECOND_OF_MINUTE}, {@link #SECOND_OF_DAY} or {@link
+ * return a value for {@link #SECOND_OF_MINUTE} , {@link #SECOND_OF_DAY} or {@link
* #INSTANT_SECONDS} filling unknown precision with zero.
*
* When this field is used for setting a value, it should behave in the same way as setting {@link
@@ -398,12 +398,12 @@ object ChronoField {
* The year within the era.
*
* This represents the concept of the year within the era. This field is typically used with
- * {@link #ERA}.
+ * {@link #ERA} .
*
* The standard mental model for a date is based on three concepts - year, month and day. These
- * map onto the {@code YEAR}, {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
+ * map onto the {@code YEAR} , {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
* there is no reference to eras. The full model for a date requires four concepts - era, year,
- * month and day. These map onto the {@code ERA}, {@code YEAR_OF_ERA}, {@code MONTH_OF_YEAR} and
+ * month and day. These map onto the {@code ERA} , {@code YEAR_OF_ERA} , {@code MONTH_OF_YEAR} and
* {@code DAY_OF_MONTH} fields. Whether this field or {@code YEAR} is used depends on which mental
* model is being used. See {@link ChronoLocalDate} for more discussion on this topic.
*
@@ -443,9 +443,9 @@ object ChronoField {
* showing the mapping from proleptic year to year-of-era.
*
* The standard mental model for a date is based on three concepts - year, month and day. These
- * map onto the {@code YEAR}, {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
+ * map onto the {@code YEAR} , {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
* there is no reference to eras. The full model for a date requires four concepts - era, year,
- * month and day. These map onto the {@code ERA}, {@code YEAR_OF_ERA}, {@code MONTH_OF_YEAR} and
+ * month and day. These map onto the {@code ERA} , {@code YEAR_OF_ERA} , {@code MONTH_OF_YEAR} and
* {@code DAY_OF_MONTH} fields. Whether this field or {@code YEAR_OF_ERA} is used depends on which
* mental model is being used. See {@link ChronoLocalDate} for more discussion on this topic.
*
@@ -467,7 +467,7 @@ object ChronoField {
* The era.
*
* This represents the concept of the era, which is the largest division of the time-line. This
- * field is typically used with {@link #YEAR_OF_ERA}.
+ * field is typically used with {@link #YEAR_OF_ERA} .
*
* In the default ISO calendar system, there are two eras defined, 'BCE' and 'CE'. The era 'CE' is
* the one currently in use and year-of-era runs from 1 to the maximum value. The era 'BCE' is the
@@ -508,7 +508,7 @@ object ChronoField {
* A {@link ZoneOffset} represents the period of time that local time differs from UTC/Greenwich.
* This is usually a fixed number of hours and minutes. It is equivalent to the {@link
* ZoneOffset#getTotalSeconds() total amount} of the offset in seconds. For example, during the
- * winter Paris has an offset of {@code +01:00}, which is 3600 seconds.
+ * winter Paris has an offset of {@code +01:00} , which is 3600 seconds.
*
* This field is strictly defined to have the same meaning in all calendar systems. This is
* necessary to ensure interoperation between calendars.
@@ -619,10 +619,10 @@ final class ChronoField private (
def checkValidValue(value: Long): Long = _range.checkValidValue(value, this)
/**
- * Checks that the specified value is valid and fits in an {@code int}.
+ * Checks that the specified value is valid and fits in an {@code int} .
*
* This validates that the value is within the outer range of valid values returned by {@link
- * #range()}. It also checks that all valid values are within the bounds of an {@code int}.
+ * #range()}. It also checks that all valid values are within the bounds of an {@code int} .
*
* This method checks against the range of the field in the ISO-8601 calendar system. This range
* may be incorrect for other calendar systems. Use {@link Chronology#range(ChronoField)} to
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoUnit.scala b/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoUnit.scala
index cd5121774..d68c8f351 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoUnit.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/temporal/ChronoUnit.scala
@@ -40,7 +40,7 @@ import org.threeten.bp.chrono.ChronoZonedDateTime
* A standard set of date periods units.
*
* This set of units provide unit-based access to manipulate a date, time or date-time. The standard
- * set of units can be extended by implementing {@link TemporalUnit}.
+ * set of units can be extended by implementing {@link TemporalUnit} .
*
* These units are intended to be applicable in multiple calendar systems. For example, most non-ISO
* calendar systems define units of years, months and days, just with slightly different rules. The
@@ -94,7 +94,7 @@ object ChronoUnit {
/**
* Unit that represents the concept of a day. For the ISO calendar system, it is the standard day
- * from midnight to midnight. The estimated duration of a day is {@code 24 Hours}.
+ * from midnight to midnight. The estimated duration of a day is {@code 24 Hours} .
*
* When used with other calendar systems it must correspond to the day defined by the rising and
* setting of the Sun on Earth. It is not required that days begin at midnight - when converting
@@ -120,7 +120,7 @@ object ChronoUnit {
/**
* Unit that represents the concept of a year. For the ISO calendar system, it is equal to 12
- * months. The estimated duration of a year is {@code 365.2425 Days}.
+ * months. The estimated duration of a year is {@code 365.2425 Days} .
*
* When used with other calendar systems it must correspond to an integral number of days or
* months roughly equal to a year defined by the passage of the Earth around the Sun.
@@ -157,7 +157,7 @@ object ChronoUnit {
/**
* Unit that represents the concept of an era. The ISO calendar system doesn't have eras thus it
* is impossible to add an era to a date or date-time. The estimated duration of the era is
- * artificially defined as {@code 1,000,000,000 Years}.
+ * artificially defined as {@code 1,000,000,000 Years} .
*
* When used with other calendar systems there are no restrictions on the unit.
*/
@@ -166,7 +166,7 @@ object ChronoUnit {
/**
* Artificial unit that represents the concept of forever. This is primarily used with {@link
* TemporalField} to represent unbounded fields such as the year or era. The estimated duration of
- * the era is artificially defined as the largest duration supported by {@code Duration}.
+ * the era is artificially defined as the largest duration supported by {@code Duration} .
*/
lazy val FOREVER = new ChronoUnit("Forever", 15, Duration.ofSeconds(Long.MaxValue, 999999999))
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/temporal/IsoFields.scala b/core/shared/src/main/scala-2/org/threeten/bp/temporal/IsoFields.scala
index 50ac10304..b69c8bfe0 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/temporal/IsoFields.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/temporal/IsoFields.scala
@@ -158,7 +158,7 @@ object IsoFields {
*
* This allows a number of week-based-years to be added to, or subtracted from, a date. The unit
* is equal to either 52 or 53 weeks. The estimated duration of a week-based-year is the same as
- * that of a standard ISO year at {@code 365.2425 Days}.
+ * that of a standard ISO year at {@code 365.2425 Days} .
*
* The rules for addition add the number of week-based-years to the existing value for the
* week-based-year field. If the resulting week-based-year only has 52 weeks, then the date will
@@ -170,7 +170,7 @@ object IsoFields {
/**
* Unit that represents the concept of a quarter-year. For the ISO calendar system, it is equal to
- * 3 months. The estimated duration of a quarter-year is one quarter of {@code 365.2425 Days}.
+ * 3 months. The estimated duration of a quarter-year is one quarter of {@code 365.2425 Days} .
*
* This unit is an immutable and thread-safe singleton.
*/
@@ -259,13 +259,13 @@ object IsoFields {
private def QY = "QuarterOfYear"
lazy val QUARTER_OF_YEAR: Field = new Field("QUARTER_OF_YEAR", 1) {
- override def toString: String = QY
- def getBaseUnit: TemporalUnit = QUARTER_YEARS
- def getRangeUnit: TemporalUnit = YEARS
- def range: ValueRange = ValueRange.of(1, 4)
- def isSupportedBy(temporal: TemporalAccessor): Boolean =
+ override def toString: String = QY
+ def getBaseUnit: TemporalUnit = QUARTER_YEARS
+ def getRangeUnit: TemporalUnit = YEARS
+ def range: ValueRange = ValueRange.of(1, 4)
+ def isSupportedBy(temporal: TemporalAccessor): Boolean =
temporal.isSupported(MONTH_OF_YEAR) && isIso(temporal)
- def rangeRefinedBy(temporal: TemporalAccessor): ValueRange = range
+ def rangeRefinedBy(temporal: TemporalAccessor): ValueRange = range
def getFrom(temporal: TemporalAccessor): Long = {
if (!temporal.isSupported(this))
throw unsupportedEx(QY)
@@ -349,13 +349,13 @@ object IsoFields {
new UnsupportedTemporalTypeException(s"Unsupported field: $f")
lazy val WEEK_BASED_YEAR: Field = new Field("WEEK_BASED_YEAR", 3) {
- override def toString: String = WBY
- def getBaseUnit: TemporalUnit = WEEK_BASED_YEARS
- def getRangeUnit: TemporalUnit = FOREVER
- def range: ValueRange = YEAR.range
- def isSupportedBy(temporal: TemporalAccessor): Boolean =
+ override def toString: String = WBY
+ def getBaseUnit: TemporalUnit = WEEK_BASED_YEARS
+ def getRangeUnit: TemporalUnit = FOREVER
+ def range: ValueRange = YEAR.range
+ def isSupportedBy(temporal: TemporalAccessor): Boolean =
temporal.isSupported(EPOCH_DAY) && isIso(temporal)
- def rangeRefinedBy(temporal: TemporalAccessor): ValueRange = YEAR.range
+ def rangeRefinedBy(temporal: TemporalAccessor): ValueRange = YEAR.range
def getFrom(temporal: TemporalAccessor): Long =
if (!temporal.isSupported(this))
throw unsupportedEx(WBY)
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/temporal/JulianFields.scala b/core/shared/src/main/scala-2/org/threeten/bp/temporal/JulianFields.scala
index 0ef1f8628..b8f4f39e5 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/temporal/JulianFields.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/temporal/JulianFields.scala
@@ -62,7 +62,7 @@ object JulianFields {
* For date-times, 'JULIAN_DAY.getFrom()' assumes the same value from midnight until just before
* the next midnight. When 'JULIAN_DAY.adjustInto()' is applied to a date-time, the time of day
* portion remains unaltered. 'JULIAN_DAY.adjustInto()' and 'JULIAN_DAY.getFrom()' only apply to
- * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY}. A {@link
+ * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY} . A {@link
* DateTimeException} is thrown for any other type of object.
*
* Astronomical and Scientific Notes
The standard astronomical definition uses a fraction
@@ -94,15 +94,15 @@ object JulianFields {
*
* This is an integer-based version of the Modified Julian Day Number. Modified Julian Day (MJD)
* is a well-known system that counts days continuously. It is defined relative to astronomical
- * Julian Day as {@code MJD = JD - 2400000.5}. Each Modified Julian Day runs from midnight to
+ * Julian Day as {@code MJD = JD - 2400000.5} . Each Modified Julian Day runs from midnight to
* midnight. The field always refers to the local date-time, ignoring the offset or zone.
*
* For date-times, 'MODIFIED_JULIAN_DAY.getFrom()' assumes the same value from midnight until just
* before the next midnight. When 'MODIFIED_JULIAN_DAY.adjustInto()' is applied to a date-time,
* the time of day portion remains unaltered. 'MODIFIED_JULIAN_DAY.adjustInto()' and
* 'MODIFIED_JULIAN_DAY.getFrom()' only apply to {@code Temporal} objects that can be converted
- * into {@link ChronoField#EPOCH_DAY}. A {@link DateTimeException} is thrown for any other type of
- * object.
+ * into {@link ChronoField#EPOCH_DAY} . A {@link DateTimeException} is thrown for any other type
+ * of object.
*
* This implementation is an integer version of MJD with the decimal part rounded to floor.
*
@@ -133,7 +133,7 @@ object JulianFields {
* For date-times, 'RATA_DIE.getFrom()' assumes the same value from midnight until just before the
* next midnight. When 'RATA_DIE.adjustInto()' is applied to a date-time, the time of day portion
* remains unaltered. 'MODIFIED_JULIAN_DAY.adjustInto()' and 'RATA_DIE.getFrom()' only apply to
- * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY}. A {@link
+ * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY} . A {@link
* DateTimeException} is thrown for any other type of object.
*/
lazy val RATA_DIE: TemporalField = Field.RATA_DIE
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneMap.scala b/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneMap.scala
index f4c6aa966..5e5a4267a 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneMap.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneMap.scala
@@ -12,7 +12,7 @@ import scala.collection.immutable
// TreeMap is not available in Scala.js however it is needed for Time Zone support
// This is a simple implementation of NavigableMap, performance is likely terrible
private[bp] class ZoneMap[K: ClassTag, V] private[bp] (var map: immutable.TreeMap[K, V])(implicit
- ordering: Ordering[K]
+ ordering: Ordering[K]
) extends AbstractMap[K, V]
with java.util.NavigableMap[K, V] {
def this()(implicit ordering: Ordering[K]) =
@@ -164,6 +164,6 @@ private[bp] class ZoneMap[K: ClassTag, V] private[bp] (var map: immutable.TreeMa
object ZoneMap {
def apply[K: ClassTag, V](map: immutable.TreeMap[K, V])(implicit
- ordering: Ordering[K]
+ ordering: Ordering[K]
): java.util.NavigableMap[K, V] = new ZoneMap[K, V](map)
}
diff --git a/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala b/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala
index c0d2defaf..b7ceff876 100644
--- a/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala
+++ b/core/shared/src/main/scala-2/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala
@@ -60,15 +60,15 @@ object ZoneOffsetTransitionRule {
/**
* Obtains an instance defining the yearly rule to create transitions between two offsets.
*
- * Applications should normally obtain an instance from {@link ZoneRules}. This factory is only
- * intended for use when creating {@link ZoneRules}.
+ * Applications should normally obtain an instance from {@link ZoneRules} . This factory is only
+ * intended for use when creating {@link ZoneRules} .
*
* @param month
* the month of the month-day of the first day of the cutover week, not null
* @param dayOfMonthIndicator
* the day of the month-day of the cutover week, positive if the week is that day or later,
* negative if the week is that day or earlier, counting from the last day of the month, from
- * -28 to 31 excluding 0
+ * -28 to 31 excluding 0
* @param dayOfWeek
* the required day-of-week, null if the month-day should not be changed
* @param time
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/DayOfWeek.scala b/core/shared/src/main/scala-3/org/threeten/bp/DayOfWeek.scala
index 2c4cc0f56..6162303de 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/DayOfWeek.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/DayOfWeek.scala
@@ -60,7 +60,7 @@ import org.threeten.bp.temporal.ValueRange
* assign different numeric values to the days, declaring Sunday to have the value 1, however this
* class provides no support for this. See {@link WeekFields} for localized week-numbering.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code DayOfWeek}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code DayOfWeek} . Use
* {@code getValue()} instead.
*
* This enum represents a common concept that is found in many calendar systems. As such, this enum
@@ -100,19 +100,19 @@ object DayOfWeek {
* Obtains an instance of {@code DayOfWeek} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code DayOfWeek}.
+ * converts the arbitrary temporal object to an instance of {@code DayOfWeek} .
*
* The conversion extracts the {@link ChronoField#DAY_OF_WEEK DAY_OF_WEEK} field.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used as a query via method reference, {@code DayOfWeek::from}.
+ * to be used as a query via method reference, {@code DayOfWeek::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the day-of-week, not null
* @throws DateTimeException
- * if unable to convert to a { @code DayOfWeek}
+ * if unable to convert to a {@code DayOfWeek}
*/
def from(temporal: TemporalAccessor): DayOfWeek = {
temporal match {
@@ -136,12 +136,13 @@ enum DayOfWeek(name: String, ordinal: Int)
with TemporalAdjuster {
/**
- * The singleton instance for the day-of-week of Monday. This has the numeric value of {@code 1}.
+ * The singleton instance for the day-of-week of Monday. This has the numeric value of {@code 1} .
*/
case MONDAY extends DayOfWeek("MONDAY", 0)
/**
- * The singleton instance for the day-of-week of Tuesday. This has the numeric value of {@code 2}.
+ * The singleton instance for the day-of-week of Tuesday. This has the numeric value of {@code 2}
+ * .
*/
case TUESDAY extends DayOfWeek("TUESDAY", 1)
@@ -158,7 +159,7 @@ enum DayOfWeek(name: String, ordinal: Int)
case THURSDAY extends DayOfWeek("THURSDAY", 3)
/**
- * The singleton instance for the day-of-week of Friday. This has the numeric value of {@code 5}.
+ * The singleton instance for the day-of-week of Friday. This has the numeric value of {@code 5} .
*/
case FRIDAY extends DayOfWeek("FRIDAY", 4)
@@ -169,7 +170,7 @@ enum DayOfWeek(name: String, ordinal: Int)
case SATURDAY extends DayOfWeek("SATURDAY", 5)
/**
- * The singleton instance for the day-of-week of Sunday. This has the numeric value of {@code 7}.
+ * The singleton instance for the day-of-week of Sunday. This has the numeric value of {@code 7} .
*/
case SUNDAY extends DayOfWeek("SUNDAY", 6)
@@ -212,7 +213,7 @@ enum DayOfWeek(name: String, ordinal: Int)
* If the field is {@link ChronoField#DAY_OF_WEEK DAY_OF_WEEK} then this method returns true. All
* other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -238,7 +239,7 @@ enum DayOfWeek(name: String, ordinal: Int)
* from 1 to 7, will be returned. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -258,7 +259,7 @@ enum DayOfWeek(name: String, ordinal: Int)
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this day-of-week as an {@code int}.
+ * Gets the value of the specified field from this day-of-week as an {@code int} .
*
* This queries this day-of-week for the value for the specified field. The returned value will
* always be within the valid range of values for the field. If it is not possible to return the
@@ -268,7 +269,7 @@ enum DayOfWeek(name: String, ordinal: Int)
* from 1 to 7, will be returned. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -279,7 +280,7 @@ enum DayOfWeek(name: String, ordinal: Int)
* @throws DateTimeException
* if a value for the field cannot be obtained
* @throws DateTimeException
- * if the range of valid values for the field exceeds an { @code int}
+ * if the range of valid values for the field exceeds an {@code int}
* @throws DateTimeException
* if the value is outside the range of valid values for the field
* @throws ArithmeticException
@@ -292,7 +293,7 @@ enum DayOfWeek(name: String, ordinal: Int)
range(field).checkValidIntValue(getLong(field), field)
/**
- * Gets the value of the specified field from this day-of-week as a {@code long}.
+ * Gets the value of the specified field from this day-of-week as a {@code long} .
*
* This queries this day-of-week for the value for the specified field. If it is not possible to
* return the value, because the field is not supported or for some other reason, an exception is
@@ -302,7 +303,7 @@ enum DayOfWeek(name: String, ordinal: Int)
* from 1 to 7, will be returned. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -397,7 +398,7 @@ enum DayOfWeek(name: String, ordinal: Int)
* The adjustment is equivalent to using {@link Temporal#with(TemporalField, long)} passing {@link
* ChronoField#DAY_OF_WEEK} as the field. Note that this adjusts forwards or backwards within a
* Monday to Sunday week. See {@link WeekFields#dayOfWeek} for localized week start days. See
- * {@link TemporalAdjusters} for other adjusters with more control, such as {@code next(MONDAY)}.
+ * {@link TemporalAdjusters} for other adjusters with more control, such as {@code next(MONDAY)} .
*
* In most cases, it is clearer to reverse the calling pattern by using {@link
* Temporal#with(TemporalAdjuster)}: // these two lines are equivalent, but the second
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/Month.scala b/core/shared/src/main/scala-3/org/threeten/bp/Month.scala
index c46abd64f..ea703f864 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/Month.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/Month.scala
@@ -60,8 +60,8 @@ import org.threeten.bp.temporal.ValueRange
* is recommended that applications use the enum rather than the {@code int} value to ensure code
* clarity.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code Month}. Use {@code
- * getValue()} instead.
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code Month} . Use
+ * {@code getValue()} instead.
*
* This enum represents a common concept that is found in many calendar systems. As such, this enum
* may be used by any calendar system that has the month-of-year concept defined exactly equivalent
@@ -100,21 +100,21 @@ object Month {
* Obtains an instance of {@code Month} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code Month}.
+ * converts the arbitrary temporal object to an instance of {@code Month} .
*
* The conversion extracts the {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} field. The
* extraction is only permitted if the temporal object has an ISO chronology, or can be converted
- * to a {@code LocalDate}.
+ * to a {@code LocalDate} .
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code Month::from}.
+ * to be used in queries via method reference, {@code Month::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the month-of-year, not null
* @throws DateTimeException
- * if unable to convert to a { @code Month}
+ * if unable to convert to a {@code Month}
*/
def from(temporal: TemporalAccessor): Month = {
var _temporal = temporal
@@ -143,25 +143,25 @@ enum Month private (name: String, ordinal: Int)
/**
* The singleton instance for the month of January with 31 days. This has the numeric value of
- * {@code 1}.
+ * {@code 1} .
*/
case JANUARY extends Month("JANUARY", 0)
/**
* The singleton instance for the month of February with 28 days, or 29 in a leap year. This has
- * the numeric value of {@code 2}.
+ * the numeric value of {@code 2} .
*/
case FEBRUARY extends Month("FEBRUARY", 1)
/**
* The singleton instance for the month of March with 31 days. This has the numeric value of
- * {@code 3}.
+ * {@code 3} .
*/
case MARCH extends Month("MARCH", 2)
/**
* The singleton instance for the month of April with 30 days. This has the numeric value of
- * {@code 4}.
+ * {@code 4} .
*/
case APRIL extends Month("APRIL", 3)
@@ -185,31 +185,31 @@ enum Month private (name: String, ordinal: Int)
/**
* The singleton instance for the month of August with 31 days. This has the numeric value of
- * {@code 8}.
+ * {@code 8} .
*/
case AUGUST extends Month("AUGUST", 7)
/**
* The singleton instance for the month of September with 30 days. This has the numeric value of
- * {@code 9}.
+ * {@code 9} .
*/
case SEPTEMBER extends Month("SEPTEMBER", 8)
/**
* The singleton instance for the month of October with 31 days. This has the numeric value of
- * {@code 10}.
+ * {@code 10} .
*/
case OCTOBER extends Month("OCTOBER", 9)
/**
* The singleton instance for the month of November with 30 days. This has the numeric value of
- * {@code 11}.
+ * {@code 11} .
*/
case NOVEMBER extends Month("NOVEMBER", 10)
/**
* The singleton instance for the month of December with 31 days. This has the numeric value of
- * {@code 12}.
+ * {@code 12} .
*/
case DECEMBER extends Month("DECEMBER", 11)
@@ -253,7 +253,7 @@ enum Month private (name: String, ordinal: Int)
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then this method returns true.
* All other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -277,9 +277,9 @@ enum Month private (name: String, ordinal: Int)
*
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then the range of the
* month-of-year, from 1 to 12, will be returned. All other {@code ChronoField} instances will
- * throw a {@code DateTimeException}.
+ * throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -299,7 +299,7 @@ enum Month private (name: String, ordinal: Int)
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this month-of-year as an {@code int}.
+ * Gets the value of the specified field from this month-of-year as an {@code int} .
*
* This queries this month for the value for the specified field. The returned value will always
* be within the valid range of values for the field. If it is not possible to return the value,
@@ -307,9 +307,9 @@ enum Month private (name: String, ordinal: Int)
*
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then the value of the
* month-of-year, from 1 to 12, will be returned. All other {@code ChronoField} instances will
- * throw a {@code DateTimeException}.
+ * throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -320,7 +320,7 @@ enum Month private (name: String, ordinal: Int)
* @throws DateTimeException
* if a value for the field cannot be obtained
* @throws DateTimeException
- * if the range of valid values for the field exceeds an { @code int}
+ * if the range of valid values for the field exceeds an {@code int}
* @throws DateTimeException
* if the value is outside the range of valid values for the field
* @throws ArithmeticException
@@ -333,16 +333,16 @@ enum Month private (name: String, ordinal: Int)
range(field).checkValidIntValue(getLong(field), field)
/**
- * Gets the value of the specified field from this month-of-year as a {@code long}.
+ * Gets the value of the specified field from this month-of-year as a {@code long} .
*
* This queries this month for the value for the specified field. If it is not possible to return
* the value, because the field is not supported or for some other reason, an exception is thrown.
*
* If the field is {@link ChronoField#MONTH_OF_YEAR MONTH_OF_YEAR} then the value of the
* month-of-year, from 1 to 12, will be returned. All other {@code ChronoField} instances will
- * throw a {@code DateTimeException}.
+ * throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/chrono/HijrahEra.scala b/core/shared/src/main/scala-3/org/threeten/bp/chrono/HijrahEra.scala
index 1d28e44d9..54a4461ed 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/chrono/HijrahEra.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/chrono/HijrahEra.scala
@@ -68,7 +68,7 @@ object HijrahEra {
* The Hijrah calendar system has two eras. The date {@code 0001-01-01 (Hijrah)} is {@code 622-06-19
* (ISO)}.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code HijrahEra}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code HijrahEra} . Use
* {@code getValue()} instead.
*
*
*
* This method only considers the position of the two dates on the local time-line. It does not
* take into account the chronology, or calendar system. This is different from the comparison in
- * {@link #compareTo(ChronoLocalDate)}, but is the same approach as {@link #DATE_COMPARATOR}.
+ * {@link #compareTo(ChronoLocalDate)} , but is the same approach as {@link #DATE_COMPARATOR} .
*
* @param other
* the other date to compare to, not null
@@ -1640,12 +1638,11 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
*
* This checks to see if this date represents the same point on the local time-line as the other
* date. Specification for implementors
This is an immutable and thread-safe enum.
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/chrono/IsoEra.scala b/core/shared/src/main/scala-3/org/threeten/bp/chrono/IsoEra.scala
index 4625e136a..8532e0326 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/chrono/IsoEra.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/chrono/IsoEra.scala
@@ -63,7 +63,7 @@ object IsoEra {
* \- 'Current era' (CE) for years from 0001-01-01 (ISO) and 'Before current era' (BCE) for years
* before that.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code IsoEra}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code IsoEra} . Use
* {@code getValue()} instead.
*
* Specification for implementors
This is an immutable and thread-safe enum.
@@ -73,14 +73,14 @@ enum IsoEra(name: String, ordinal: Int) extends java.lang.Enum[IsoEra] with Era
/**
* The singleton instance for the era BCE, 'Before Current Era'. The 'ISO' part of the name
* emphasizes that this differs from the BCE era in the Gregorian calendar system. This has the
- * numeric value of {@code 0}.
+ * numeric value of {@code 0} .
*/
case BCE extends IsoEra("BCE", 0)
/**
* The singleton instance for the era CE, 'Current Era'. The 'ISO' part of the name emphasizes
* that this differs from the CE era in the Gregorian calendar system. This has the numeric value
- * of {@code 1}.
+ * of {@code 1} .
*/
case CE extends IsoEra("CE", 1)
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/chrono/MinguoEra.scala b/core/shared/src/main/scala-3/org/threeten/bp/chrono/MinguoEra.scala
index ce3660ba7..b46e5327c 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/chrono/MinguoEra.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/chrono/MinguoEra.scala
@@ -63,7 +63,7 @@ object MinguoEra {
* The Minguo calendar system has two eras. The date {@code 0001-01-01 (Minguo)} is equal to {@code
* 1912-01-01 (ISO)}.
*
- * Do not use {@code ordinal()} to obtain the numeric representation of {@code MinguoEra}. Use
+ * Do not use {@code ordinal()} to obtain the numeric representation of {@code MinguoEra} . Use
* {@code getValue()} instead.
*
* Specification for implementors
This is an immutable and thread-safe enum.
@@ -72,13 +72,13 @@ enum MinguoEra(name: String, ordinal: Int) extends java.lang.Enum[MinguoEra] wit
/**
* The singleton instance for the era BEFORE_ROC, 'Before Republic of China'. This has the numeric
- * value of {@code 0}.
+ * value of {@code 0} .
*/
case BEFORE_ROC extends MinguoEra("BEFORE_ROC", 0)
/**
* The singleton instance for the era ROC, 'Republic of China'. This has the numeric value of
- * {@code 1}.
+ * {@code 1} .
*/
case ROC extends MinguoEra("ROC", 1)
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala b/core/shared/src/main/scala-3/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala
index 876addf5e..dcc2ca22a 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/format/internal/TTBPDateTimeFormatterBuilder.scala
@@ -279,8 +279,8 @@ object TTBPDateTimeFormatterBuilder {
* @param signStyle
* the positive/negative sign style, not null
* @param subsequentWidth
- * the width of subsequent non-negative numbers, 0 or greater,
- * -1 if fixed width due to active adjacent parsing
+ * the width of subsequent non-negative numbers, 0 or greater, -1 if fixed width due to active
+ * adjacent parsing
*/
private[format] class NumberPrinterParser private[format] (
private[format] val field: TemporalField,
@@ -794,8 +794,8 @@ object TTBPDateTimeFormatterBuilder {
*
* The fractional value must be between 0 (inclusive) and 1 (exclusive). It can only be returned
* if the {@link TemporalField#range() value range} is fixed. The value is obtained by
- * calculation from the field range and a rounding mode of {@link RoundingMode#FLOOR FLOOR}. The
- * calculation is inaccurate if the values do not run continuously from smallest to largest.
+ * calculation from the field range and a rounding mode of {@link RoundingMode#FLOOR FLOOR} .
+ * The calculation is inaccurate if the values do not run continuously from smallest to largest.
*
* For example, the fractional second-of-minute of 0.25 would be converted to 15, assuming the
* standard definition of 60 seconds in a minute.
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoField.scala b/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoField.scala
index 50491e1f9..d1ab915e0 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoField.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoField.scala
@@ -52,7 +52,7 @@ import org.threeten.bp.format.ResolverStyle
* A standard set of fields.
*
* This set of fields provide field-based access to manipulate a date, time or date-time. The
- * standard set of fields can be extended by implementing {@link TemporalField}.
+ * standard set of fields can be extended by implementing {@link TemporalField} .
*
* These fields are intended to be applicable in multiple calendar systems. For example, most
* non-ISO calendar systems define dates as a year, month and day, just with slightly different
@@ -80,7 +80,7 @@ enum ChronoField private (
*
* This field is used to represent the nano-of-second handling any fraction of the second.
* Implementations of {@code TemporalAccessor} should provide a value for this field if they can
- * return a value for {@link #SECOND_OF_MINUTE}, {@link #SECOND_OF_DAY} or {@link
+ * return a value for {@link #SECOND_OF_MINUTE} , {@link #SECOND_OF_DAY} or {@link
* #INSTANT_SECONDS} filling unknown precision with zero.
*
* When this field is used for setting a value, it should set as much precision as the object
@@ -112,7 +112,7 @@ enum ChronoField private (
*
* This field is used to represent the micro-of-second handling any fraction of the second.
* Implementations of {@code TemporalAccessor} should provide a value for this field if they can
- * return a value for {@link #SECOND_OF_MINUTE}, {@link #SECOND_OF_DAY} or {@link
+ * return a value for {@link #SECOND_OF_MINUTE} , {@link #SECOND_OF_DAY} or {@link
* #INSTANT_SECONDS} filling unknown precision with zero.
*
* When this field is used for setting a value, it should behave in the same way as setting {@link
@@ -145,7 +145,7 @@ enum ChronoField private (
*
* This field is used to represent the milli-of-second handling any fraction of the second.
* Implementations of {@code TemporalAccessor} should provide a value for this field if they can
- * return a value for {@link #SECOND_OF_MINUTE}, {@link #SECOND_OF_DAY} or {@link
+ * return a value for {@link #SECOND_OF_MINUTE} , {@link #SECOND_OF_DAY} or {@link
* #INSTANT_SECONDS} filling unknown precision with zero.
*
* When this field is used for setting a value, it should behave in the same way as setting {@link
@@ -414,12 +414,12 @@ enum ChronoField private (
* The year within the era.
*
* This represents the concept of the year within the era. This field is typically used with
- * {@link #ERA}.
+ * {@link #ERA} .
*
* The standard mental model for a date is based on three concepts - year, month and day. These
- * map onto the {@code YEAR}, {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
+ * map onto the {@code YEAR} , {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
* there is no reference to eras. The full model for a date requires four concepts - era, year,
- * month and day. These map onto the {@code ERA}, {@code YEAR_OF_ERA}, {@code MONTH_OF_YEAR} and
+ * month and day. These map onto the {@code ERA} , {@code YEAR_OF_ERA} , {@code MONTH_OF_YEAR} and
* {@code DAY_OF_MONTH} fields. Whether this field or {@code YEAR} is used depends on which mental
* model is being used. See {@link ChronoLocalDate} for more discussion on this topic.
*
@@ -460,9 +460,9 @@ enum ChronoField private (
* showing the mapping from proleptic year to year-of-era.
*
* The standard mental model for a date is based on three concepts - year, month and day. These
- * map onto the {@code YEAR}, {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
+ * map onto the {@code YEAR} , {@code MONTH_OF_YEAR} and {@code DAY_OF_MONTH} fields. Note that
* there is no reference to eras. The full model for a date requires four concepts - era, year,
- * month and day. These map onto the {@code ERA}, {@code YEAR_OF_ERA}, {@code MONTH_OF_YEAR} and
+ * month and day. These map onto the {@code ERA} , {@code YEAR_OF_ERA} , {@code MONTH_OF_YEAR} and
* {@code DAY_OF_MONTH} fields. Whether this field or {@code YEAR_OF_ERA} is used depends on which
* mental model is being used. See {@link ChronoLocalDate} for more discussion on this topic.
*
@@ -484,7 +484,7 @@ enum ChronoField private (
* The era.
*
* This represents the concept of the era, which is the largest division of the time-line. This
- * field is typically used with {@link #YEAR_OF_ERA}.
+ * field is typically used with {@link #YEAR_OF_ERA} .
*
* In the default ISO calendar system, there are two eras defined, 'BCE' and 'CE'. The era 'CE' is
* the one currently in use and year-of-era runs from 1 to the maximum value. The era 'BCE' is the
@@ -526,7 +526,7 @@ enum ChronoField private (
* A {@link ZoneOffset} represents the period of time that local time differs from UTC/Greenwich.
* This is usually a fixed number of hours and minutes. It is equivalent to the {@link
* ZoneOffset#getTotalSeconds() total amount} of the offset in seconds. For example, during the
- * winter Paris has an offset of {@code +01:00}, which is 3600 seconds.
+ * winter Paris has an offset of {@code +01:00} , which is 3600 seconds.
*
* This field is strictly defined to have the same meaning in all calendar systems. This is
* necessary to ensure interoperation between calendars.
@@ -630,10 +630,10 @@ enum ChronoField private (
def checkValidValue(value: Long): Long = _range.checkValidValue(value, this)
/**
- * Checks that the specified value is valid and fits in an {@code int}.
+ * Checks that the specified value is valid and fits in an {@code int} .
*
* This validates that the value is within the outer range of valid values returned by {@link
- * #range()}. It also checks that all valid values are within the bounds of an {@code int}.
+ * #range()}. It also checks that all valid values are within the bounds of an {@code int} .
*
* This method checks against the range of the field in the ISO-8601 calendar system. This range
* may be incorrect for other calendar systems. Use {@link Chronology#range(ChronoField)} to
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoUnit.scala b/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoUnit.scala
index 1dc0d2b79..ffb362cce 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoUnit.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/temporal/ChronoUnit.scala
@@ -40,7 +40,7 @@ import org.threeten.bp.chrono.ChronoZonedDateTime
* A standard set of date periods units.
*
* This set of units provide unit-based access to manipulate a date, time or date-time. The standard
- * set of units can be extended by implementing {@link TemporalUnit}.
+ * set of units can be extended by implementing {@link TemporalUnit} .
*
* These units are intended to be applicable in multiple calendar systems. For example, most non-ISO
* calendar systems define units of years, months and days, just with slightly different rules. The
@@ -99,7 +99,7 @@ enum ChronoUnit private (name: String, ordinal: Int, private val duration: Durat
/**
* Unit that represents the concept of a day. For the ISO calendar system, it is the standard day
- * from midnight to midnight. The estimated duration of a day is {@code 24 Hours}.
+ * from midnight to midnight. The estimated duration of a day is {@code 24 Hours} .
*
* When used with other calendar systems it must correspond to the day defined by the rising and
* setting of the Sun on Earth. It is not required that days begin at midnight - when converting
@@ -125,7 +125,7 @@ enum ChronoUnit private (name: String, ordinal: Int, private val duration: Durat
/**
* Unit that represents the concept of a year. For the ISO calendar system, it is equal to 12
- * months. The estimated duration of a year is {@code 365.2425 Days}.
+ * months. The estimated duration of a year is {@code 365.2425 Days} .
*
* When used with other calendar systems it must correspond to an integral number of days or
* months roughly equal to a year defined by the passage of the Earth around the Sun.
@@ -162,7 +162,7 @@ enum ChronoUnit private (name: String, ordinal: Int, private val duration: Durat
/**
* Unit that represents the concept of an era. The ISO calendar system doesn't have eras thus it
* is impossible to add an era to a date or date-time. The estimated duration of the era is
- * artificially defined as {@code 1,000,000,000 Years}.
+ * artificially defined as {@code 1,000,000,000 Years} .
*
* When used with other calendar systems there are no restrictions on the unit.
*/
@@ -171,7 +171,7 @@ enum ChronoUnit private (name: String, ordinal: Int, private val duration: Durat
/**
* Artificial unit that represents the concept of forever. This is primarily used with {@link
* TemporalField} to represent unbounded fields such as the year or era. The estimated duration of
- * the era is artificially defined as the largest duration supported by {@code Duration}.
+ * the era is artificially defined as the largest duration supported by {@code Duration} .
*/
case FOREVER extends ChronoUnit("Forever", 15, Duration.ofSeconds(Long.MaxValue, 999999999))
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/temporal/IsoFields.scala b/core/shared/src/main/scala-3/org/threeten/bp/temporal/IsoFields.scala
index 299e569b5..43f2d1c40 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/temporal/IsoFields.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/temporal/IsoFields.scala
@@ -158,7 +158,7 @@ object IsoFields {
*
* This allows a number of week-based-years to be added to, or subtracted from, a date. The unit
* is equal to either 52 or 53 weeks. The estimated duration of a week-based-year is the same as
- * that of a standard ISO year at {@code 365.2425 Days}.
+ * that of a standard ISO year at {@code 365.2425 Days} .
*
* The rules for addition add the number of week-based-years to the existing value for the
* week-based-year field. If the resulting week-based-year only has 52 weeks, then the date will
@@ -170,7 +170,7 @@ object IsoFields {
/**
* Unit that represents the concept of a quarter-year. For the ISO calendar system, it is equal to
- * 3 months. The estimated duration of a quarter-year is one quarter of {@code 365.2425 Days}.
+ * 3 months. The estimated duration of a quarter-year is one quarter of {@code 365.2425 Days} .
*
* This unit is an immutable and thread-safe singleton.
*/
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/temporal/JulianFields.scala b/core/shared/src/main/scala-3/org/threeten/bp/temporal/JulianFields.scala
index f647834c2..c5a404e28 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/temporal/JulianFields.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/temporal/JulianFields.scala
@@ -62,7 +62,7 @@ object JulianFields {
* For date-times, 'JULIAN_DAY.getFrom()' assumes the same value from midnight until just before
* the next midnight. When 'JULIAN_DAY.adjustInto()' is applied to a date-time, the time of day
* portion remains unaltered. 'JULIAN_DAY.adjustInto()' and 'JULIAN_DAY.getFrom()' only apply to
- * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY}. A {@link
+ * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY} . A {@link
* DateTimeException} is thrown for any other type of object.
*
* Astronomical and Scientific Notes
The standard astronomical definition uses a fraction
@@ -94,15 +94,15 @@ object JulianFields {
*
* This is an integer-based version of the Modified Julian Day Number. Modified Julian Day (MJD)
* is a well-known system that counts days continuously. It is defined relative to astronomical
- * Julian Day as {@code MJD = JD - 2400000.5}. Each Modified Julian Day runs from midnight to
+ * Julian Day as {@code MJD = JD - 2400000.5} . Each Modified Julian Day runs from midnight to
* midnight. The field always refers to the local date-time, ignoring the offset or zone.
*
* For date-times, 'MODIFIED_JULIAN_DAY.getFrom()' assumes the same value from midnight until just
* before the next midnight. When 'MODIFIED_JULIAN_DAY.adjustInto()' is applied to a date-time,
* the time of day portion remains unaltered. 'MODIFIED_JULIAN_DAY.adjustInto()' and
* 'MODIFIED_JULIAN_DAY.getFrom()' only apply to {@code Temporal} objects that can be converted
- * into {@link ChronoField#EPOCH_DAY}. A {@link DateTimeException} is thrown for any other type of
- * object.
+ * into {@link ChronoField#EPOCH_DAY} . A {@link DateTimeException} is thrown for any other type
+ * of object.
*
* This implementation is an integer version of MJD with the decimal part rounded to floor.
*
@@ -133,7 +133,7 @@ object JulianFields {
* For date-times, 'RATA_DIE.getFrom()' assumes the same value from midnight until just before the
* next midnight. When 'RATA_DIE.adjustInto()' is applied to a date-time, the time of day portion
* remains unaltered. 'MODIFIED_JULIAN_DAY.adjustInto()' and 'RATA_DIE.getFrom()' only apply to
- * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY}. A {@link
+ * {@code Temporal} objects that can be converted into {@link ChronoField#EPOCH_DAY} . A {@link
* DateTimeException} is thrown for any other type of object.
*/
lazy val RATA_DIE: TemporalField = Field.RATA_DIE
diff --git a/core/shared/src/main/scala-3/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala b/core/shared/src/main/scala-3/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala
index b10b69a5b..f6ae15802 100644
--- a/core/shared/src/main/scala-3/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala
+++ b/core/shared/src/main/scala-3/org/threeten/bp/zone/ZoneOffsetTransitionRule.scala
@@ -60,15 +60,15 @@ object ZoneOffsetTransitionRule {
/**
* Obtains an instance defining the yearly rule to create transitions between two offsets.
*
- * Applications should normally obtain an instance from {@link ZoneRules}. This factory is only
- * intended for use when creating {@link ZoneRules}.
+ * Applications should normally obtain an instance from {@link ZoneRules} . This factory is only
+ * intended for use when creating {@link ZoneRules} .
*
* @param month
* the month of the month-day of the first day of the cutover week, not null
* @param dayOfMonthIndicator
* the day of the month-day of the cutover week, positive if the week is that day or later,
* negative if the week is that day or earlier, counting from the last day of the month, from
- * -28 to 31 excluding 0
+ * -28 to 31 excluding 0
* @param dayOfWeek
* the required day-of-week, null if the month-day should not be changed
* @param time
diff --git a/core/shared/src/main/scala/org/threeten/bp/Clock.scala b/core/shared/src/main/scala/org/threeten/bp/Clock.scala
index ab2228149..df7ae4bf0 100644
--- a/core/shared/src/main/scala/org/threeten/bp/Clock.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/Clock.scala
@@ -42,16 +42,16 @@ object Clock {
* Obtains a clock that returns the current instant using the best available system clock,
* converting to date and time using the UTC time-zone.
*
- * This clock, rather than {@link #systemDefaultZone()}, should be used when you need the current
+ * This clock, rather than {@link #systemDefaultZone()} , should be used when you need the current
* instant without the date or time.
*
* This clock is based on the best available system clock. This may use {@link
* System#currentTimeMillis()}, or a higher resolution clock if one is available.
*
- * Conversion from instant to date or time uses the {@link ZoneOffset#UTC UTC time-zone}.
+ * Conversion from instant to date or time uses the {@link ZoneOffset#UTC UTC time-zone} .
*
- * The returned implementation is immutable, thread-safe and {@code Serializable}. It is
- * equivalent to {@code system(ZoneOffset.UTC)}.
+ * The returned implementation is immutable, thread-safe and {@code Serializable} . It is
+ * equivalent to {@code system(ZoneOffset.UTC)} .
*
* @return
* a clock that uses the best available system clock in the UTC zone, not null
@@ -70,8 +70,8 @@ object Clock {
* #systemUTC() UTC clock} should be used when you need the current instant without the date or
* time.
*
- * The returned implementation is immutable, thread-safe and {@code Serializable}. It is
- * equivalent to {@code system(ZoneId.systemDefault())}.
+ * The returned implementation is immutable, thread-safe and {@code Serializable} . It is
+ * equivalent to {@code system(ZoneId.systemDefault())} .
*
* @return
* a clock that uses the best available system clock in the default zone, not null
@@ -88,7 +88,7 @@ object Clock {
*
* Conversion from instant to date or time uses the specified time-zone.
*
- * The returned implementation is immutable, thread-safe and {@code Serializable}.
+ * The returned implementation is immutable, thread-safe and {@code Serializable} .
*
* @param zone
* the time-zone to use to convert the instant to date-time, not null
@@ -106,14 +106,14 @@ object Clock {
*
* This clock will always have the nano-of-second field set to zero. This ensures that the visible
* time ticks in whole seconds. The underlying clock is the best available system clock,
- * equivalent to using {@link #system(ZoneId)}.
+ * equivalent to using {@link #system(ZoneId)} .
*
* Implementations may use a caching strategy for performance reasons. As such, it is possible
* that the start of the second observed via this clock will be later than that observed directly
* via the underlying clock.
*
- * The returned implementation is immutable, thread-safe and {@code Serializable}. It is
- * equivalent to {@code tick(system(zone), Duration.ofSeconds(1))}.
+ * The returned implementation is immutable, thread-safe and {@code Serializable} . It is
+ * equivalent to {@code tick(system(zone), Duration.ofSeconds(1))} .
*
* @param zone
* the time-zone to use to convert the instant to date-time, not null
@@ -128,14 +128,14 @@ object Clock {
*
* This clock will always have the nano-of-second and second-of-minute fields set to zero. This
* ensures that the visible time ticks in whole minutes. The underlying clock is the best
- * available system clock, equivalent to using {@link #system(ZoneId)}.
+ * available system clock, equivalent to using {@link #system(ZoneId)} .
*
* Implementations may use a caching strategy for performance reasons. As such, it is possible
* that the start of the minute observed via this clock will be later than that observed directly
* via the underlying clock.
*
- * The returned implementation is immutable, thread-safe and {@code Serializable}. It is
- * equivalent to {@code tick(system(zone), Duration.ofMinutes(1))}.
+ * The returned implementation is immutable, thread-safe and {@code Serializable} . It is
+ * equivalent to {@code tick(system(zone), Duration.ofMinutes(1))} .
*
* @param zone
* the time-zone to use to convert the instant to date-time, not null
@@ -198,7 +198,7 @@ object Clock {
* sense. The main use case for this is in testing, where the fixed clock ensures tests are not
* dependent on the current clock.
*
- * The returned implementation is immutable, thread-safe and {@code Serializable}.
+ * The returned implementation is immutable, thread-safe and {@code Serializable} .
*
* @param fixedInstant
* the instant to use as the clock, not null
@@ -378,7 +378,7 @@ object Clock {
*
* Instances of this class are used to find the current instant, which can be interpreted using the
* stored time-zone to find the current date and time. As such, a clock can be used instead of
- * {@link System#currentTimeMillis()} and {@link TimeZone#getDefault()}.
+ * {@link System#currentTimeMillis()} and {@link TimeZone#getDefault()} .
*
* Use of a {@code Clock} is optional. All key date-time classes also have a {@code now()} factory
* method that uses the system clock in the default time zone. The primary purpose of this
@@ -393,7 +393,7 @@ object Clock {
* to be used during testing.
*
* The {@code system} factory methods provide clocks based on the best available system clock This
- * may use {@link System#currentTimeMillis()}, or a higher resolution clock if one is available.
+ * may use {@link System#currentTimeMillis()} , or a higher resolution clock if one is available.
*
* Specification for implementors
This abstract class must be implemented with care to
* ensure other operate correctly. All implementations that can be instantiated must be final,
@@ -442,12 +442,12 @@ abstract class Clock protected () {
* Gets the current millisecond instant of the clock.
*
* This returns the millisecond-based instant, measured from 1970-01-01T00:00 UTC. This is
- * equivalent to the definition of {@link System#currentTimeMillis()}.
+ * equivalent to the definition of {@link System#currentTimeMillis()} .
*
* Most applications should avoid this method and use {@link Instant} to represent an instant on
* the time-line rather than a raw millisecond value. This method is provided to allow the use of
* the clock in high performance use cases where the creation of an object would be unacceptable.
- * The default implementation currently calls {@link #instant()}.
+ * The default implementation currently calls {@link #instant()} .
*
* @return
* the current millisecond instant from this clock, measured from the Java epoch of
diff --git a/core/shared/src/main/scala/org/threeten/bp/Duration.scala b/core/shared/src/main/scala/org/threeten/bp/Duration.scala
index fc7eda6ad..67b780818 100644
--- a/core/shared/src/main/scala/org/threeten/bp/Duration.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/Duration.scala
@@ -87,9 +87,9 @@ object Duration {
* @param days
* the number of days, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws ArithmeticException
- * if the input days exceeds the capacity of { @code Duration}
+ * if the input days exceeds the capacity of {@code Duration}
*/
def ofDays(days: Long): Duration = create(Math.multiplyExact(days, 86400L), 0)
@@ -102,9 +102,9 @@ object Duration {
* @param hours
* the number of hours, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws ArithmeticException
- * if the input hours exceeds the capacity of { @code Duration}
+ * if the input hours exceeds the capacity of {@code Duration}
*/
def ofHours(hours: Long): Duration = create(Math.multiplyExact(hours, 3600L), 0)
@@ -117,9 +117,9 @@ object Duration {
* @param minutes
* the number of minutes, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws ArithmeticException
- * if the input minutes exceeds the capacity of { @code Duration}
+ * if the input minutes exceeds the capacity of {@code Duration}
*/
def ofMinutes(minutes: Long): Duration = create(Math.multiplyExact(minutes, 60L), 0)
@@ -131,7 +131,7 @@ object Duration {
* @param seconds
* the number of seconds, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
*/
def ofSeconds(seconds: Long): Duration = create(seconds, 0)
@@ -150,9 +150,9 @@ object Duration {
* @param nanoAdjustment
* the nanosecond adjustment to the number of seconds, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws ArithmeticException
- * if the adjustment causes the seconds to exceed the capacity of { @code Duration}
+ * if the adjustment causes the seconds to exceed the capacity of {@code Duration}
*/
def ofSeconds(seconds: Long, nanoAdjustment: Long): Duration = {
val secs: Long = Math.addExact(seconds, Math.floorDiv(nanoAdjustment, NANOS_PER_SECOND.toLong))
@@ -168,7 +168,7 @@ object Duration {
* @param millis
* the number of milliseconds, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
*/
def ofMillis(millis: Long): Duration = {
var secs: Long = millis / 1000
@@ -188,7 +188,7 @@ object Duration {
* @param nanos
* the number of nanoseconds, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
*/
def ofNanos(nanos: Long): Duration = {
var secs: Long = nanos / NANOS_PER_SECOND
@@ -214,7 +214,7 @@ object Duration {
* @param unit
* the unit that the duration is measured in, must have an exact duration, not null
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws DateTimeException
* if the period unit has an estimated duration
* @throws ArithmeticException
@@ -236,7 +236,7 @@ object Duration {
* @param amount
* the amount to convert, not null
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws DateTimeException
* if the amount cannot be converted
* @throws ArithmeticException
@@ -258,7 +258,7 @@ object Duration {
*
* Obtains a {@code Duration} representing the duration between two instants. This calculates the
* duration between two temporal objects of the same type. The difference in seconds is calculated
- * using {@link Temporal#until(Temporal, TemporalUnit)}. The difference in nanoseconds is
+ * using {@link Temporal#until(Temporal, TemporalUnit)} . The difference in nanoseconds is
* calculated using by querying the {@link ChronoField#NANO_OF_SECOND NANO_OF_SECOND} field.
*
* The result of this method can be a negative period if the end is before the start. To guarantee
@@ -269,11 +269,11 @@ object Duration {
* @param endExclusive
* the end instant, exclusive, not null
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws DateTimeException
* if the seconds between the temporals cannot be obtained
* @throws ArithmeticException
- * if the calculation exceeds the capacity of { @code Duration}
+ * if the calculation exceeds the capacity of {@code Duration}
*/
def between(startInclusive: Temporal, endExclusive: Temporal): Duration = {
var secs: Long = startInclusive.until(endExclusive, SECONDS)
@@ -298,7 +298,7 @@ object Duration {
}
/**
- * Obtains a {@code Duration} from a text string such as {@code PnDTnHnMn.nS}.
+ * Obtains a {@code Duration} from a text string such as {@code PnDTnHnMn.nS} .
*
* This will parse a textual representation of a duration, including the string produced by {@code
* toString()}. The formats accepted are based on the ISO-8601 duration format {@code
@@ -313,7 +313,7 @@ object Duration {
* sections must be present, and if "T" is present there must be at least one section after the
* "T". The number part of each section must consist of one or more ASCII digits. The number may
* be prefixed by the ASCII negative or positive symbol. The number of days, hours and minutes
- * must parse to a {@code long}. The number of seconds must parse to a {@code long} with optional
+ * must parse to a {@code long} . The number of seconds must parse to a {@code long} with optional
* fraction. The decimal point may be either a dot or a comma. The fractional part may have from
* zero to 9 digits.
*
@@ -452,7 +452,7 @@ object Duration {
* @param seconds
* the number of seconds, up to scale 9, positive or negative
* @return
- * a { @code Duration}, not null
+ * a {@code Duration} , not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -475,11 +475,11 @@ object Duration {
* daylight savings effects. See {@link Period} for the date-based equivalent to this class.
*
* A physical duration could be of infinite length. For practicality, the duration is stored with
- * constraints similar to {@link Instant}. The duration uses nanosecond resolution with a maximum
- * value of the seconds that can be held in a {@code long}. This is greater than the current
+ * constraints similar to {@link Instant} . The duration uses nanosecond resolution with a maximum
+ * value of the seconds that can be held in a {@code long} . This is greater than the current
* estimated age of the universe.
*
- * The range of a duration requires the storage of a number larger than a {@code long}. To achieve
+ * The range of a duration requires the storage of a number larger than a {@code long} . To achieve
* this, the class stores a {@code long} representing seconds and an {@code int} representing
* nanosecond-of-second, which will always be between 0 and 999,999,999.
*
@@ -539,7 +539,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
*
* The length of the duration is stored using two fields - seconds and nanoseconds. The
* nanoseconds part is a value from 0 to 999,999,999 that is an adjustment to the length in
- * seconds. The total duration is defined by calling this method and {@link #getNano()}.
+ * seconds. The total duration is defined by calling this method and {@link #getNano()} .
*
* A {@code Duration} represents a directed distance between two points on the time-line. A
* negative duration is expressed by the negative sign of the seconds part. A duration of -1
@@ -555,7 +555,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
*
* The length of the duration is stored using two fields - seconds and nanoseconds. The
* nanoseconds part is a value from 0 to 999,999,999 that is an adjustment to the length in
- * seconds. The total duration is defined by calling this method and {@link #getSeconds()}.
+ * seconds. The total duration is defined by calling this method and {@link #getSeconds()} .
*
* A {@code Duration} represents a directed distance between two points on the time-line. A
* negative duration is expressed by the negative sign of the seconds part. A duration of -1
@@ -577,7 +577,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param seconds
* the seconds to represent, may be negative
* @return
- * a { @code Duration} based on this period with the requested seconds, not null
+ * a {@code Duration} based on this period with the requested seconds, not null
*/
def withSeconds(seconds: Long): Duration = Duration.create(seconds, nanos)
@@ -592,7 +592,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param nanoOfSecond
* the nano-of-second to represent, from 0 to 999,999,999
* @return
- * a { @code Duration} based on this period with the requested nano-of-second, not null
+ * a {@code Duration} based on this period with the requested nano-of-second, not null
* @throws DateTimeException
* if the nano-of-second is invalid
*/
@@ -609,7 +609,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param duration
* the duration to add, positive or negative, not null
* @return
- * a { @code Duration} based on this duration with the specified duration added, not null
+ * a {@code Duration} based on this duration with the specified duration added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -630,7 +630,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param unit
* the unit that the period is measured in, must have an exact duration, not null
* @return
- * a { @code Duration} based on this duration with the specified duration added, not null
+ * a {@code Duration} based on this duration with the specified duration added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -667,7 +667,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param daysToAdd
* the days to add, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified days added, not null
+ * a {@code Duration} based on this duration with the specified days added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -682,7 +682,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param hoursToAdd
* the hours to add, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified hours added, not null
+ * a {@code Duration} based on this duration with the specified hours added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -697,7 +697,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param minutesToAdd
* the minutes to add, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified minutes added, not null
+ * a {@code Duration} based on this duration with the specified minutes added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -712,7 +712,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param secondsToAdd
* the seconds to add, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified seconds added, not null
+ * a {@code Duration} based on this duration with the specified seconds added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -726,7 +726,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param millisToAdd
* the milliseconds to add, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified milliseconds added, not null
+ * a {@code Duration} based on this duration with the specified milliseconds added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -741,7 +741,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param nanosToAdd
* the nanoseconds to add, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified nanoseconds added, not null
+ * a {@code Duration} based on this duration with the specified nanoseconds added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -757,7 +757,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param nanosToAdd
* the nanos to add, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified seconds added, not null
+ * a {@code Duration} based on this duration with the specified seconds added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -780,7 +780,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param duration
* the duration to subtract, positive or negative, not null
* @return
- * a { @code Duration} based on this duration with the specified duration subtracted, not null
+ * a {@code Duration} based on this duration with the specified duration subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -806,7 +806,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param unit
* the unit that the period is measured in, must have an exact duration, not null
* @return
- * a { @code Duration} based on this duration with the specified duration subtracted, not null
+ * a {@code Duration} based on this duration with the specified duration subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -822,7 +822,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param daysToSubtract
* the days to subtract, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified days subtracted, not null
+ * a {@code Duration} based on this duration with the specified days subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -838,7 +838,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param hoursToSubtract
* the hours to subtract, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified hours subtracted, not null
+ * a {@code Duration} based on this duration with the specified hours subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -854,7 +854,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param minutesToSubtract
* the minutes to subtract, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified minutes subtracted, not null
+ * a {@code Duration} based on this duration with the specified minutes subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -870,7 +870,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param secondsToSubtract
* the seconds to subtract, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified seconds subtracted, not null
+ * a {@code Duration} based on this duration with the specified seconds subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -886,7 +886,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param millisToSubtract
* the milliseconds to subtract, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified milliseconds subtracted, not
+ * a {@code Duration} based on this duration with the specified milliseconds subtracted, not
* null
* @throws ArithmeticException
* if numeric overflow occurs
@@ -903,8 +903,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param nanosToSubtract
* the nanoseconds to subtract, positive or negative
* @return
- * a { @code Duration} based on this duration with the specified nanoseconds subtracted, not
- * null
+ * a {@code Duration} based on this duration with the specified nanoseconds subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -920,7 +919,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param multiplicand
* the value to multiply the duration by, positive or negative
* @return
- * a { @code Duration} based on this duration multiplied by the specified scalar, not null
+ * a {@code Duration} based on this duration multiplied by the specified scalar, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -937,7 +936,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* @param divisor
* the value to divide the duration by, positive or negative, not zero
* @return
- * a { @code Duration} based on this duration divided by the specified divisor, not null
+ * a {@code Duration} based on this duration divided by the specified divisor, not null
* @throws ArithmeticException
* if the divisor is zero
* @throws ArithmeticException
@@ -950,7 +949,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
/**
* Converts this duration to the total length in seconds and fractional nanoseconds expressed as a
- * {@code BigDecimal}.
+ * {@code BigDecimal} .
*
* @return
* the total length of the duration in seconds, with a scale of 9, not null
@@ -990,12 +989,12 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* Returns a copy of this duration with the length negated.
*
* This method swaps the sign of the total length of this duration. For example, {@code PT1.3S}
- * will be returned as {@code PT-1.3S}.
+ * will be returned as {@code PT-1.3S} .
*
* This instance is immutable and unaffected by this method call.
*
* @return
- * a { @code Duration} based on this duration with the amount negated, not null
+ * a {@code Duration} based on this duration with the amount negated, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -1005,12 +1004,12 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
* Returns a copy of this duration with a positive length.
*
* This method returns a positive duration by effectively removing the sign from any negative
- * total length. For example, {@code PT-1.3S} will be returned as {@code PT1.3S}.
+ * total length. For example, {@code PT-1.3S} will be returned as {@code PT1.3S} .
*
* This instance is immutable and unaffected by this method call.
*
* @return
- * a { @code Duration} based on this duration with an absolute length, not null
+ * a {@code Duration} based on this duration with an absolute length, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -1200,7 +1199,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
def toMillisPart: Int = (nanos / Duration.NANOS_PER_MILLI).toInt
/**
- * Converts this duration to the total length in nanoseconds expressed as a {@code long}.
+ * Converts this duration to the total length in nanoseconds expressed as a {@code long} .
*
* If this duration is too large to fit in a {@code long} nanoseconds, then an exception is
* thrown.
@@ -1231,10 +1230,10 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
def toNanosPart: Int = nanos
/**
- * Compares this duration to the specified {@code Duration}.
+ * Compares this duration to the specified {@code Duration} .
*
* The comparison is based on the total length of the durations. It is "consistent with equals",
- * as defined by {@link Comparable}.
+ * as defined by {@link Comparable} .
*
* @param otherDuration
* the other duration to compare to, not null
@@ -1250,7 +1249,7 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
override def compareTo(other: Duration): Int = compare(other)
/**
- * Checks if this duration is equal to the specified {@code Duration}.
+ * Checks if this duration is equal to the specified {@code Duration} .
*
* The comparison is based on the total length of the durations.
*
@@ -1276,16 +1275,16 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
/**
* A string representation of this duration using ISO-8601 seconds based representation, such as
- * {@code PT8H6M12.345S}.
+ * {@code PT8H6M12.345S} .
*
- * The format of the returned string will be {@code PTnHnMnS}, where n is the relevant hours,
+ * The format of the returned string will be {@code PTnHnMnS} , where n is the relevant hours,
* minutes or seconds part of the duration. Any fractional seconds are placed after a decimal
* point i the seconds section. If a section has a zero value, it is omitted. The hours, minutes
* and seconds will all have the same sign.
*
* Examples: "20.345 seconds" -> "PT20.345S "15 minutes" (15 * 60 seconds) -> "PT15M" "10
* hours" (10 * 3600 seconds) -> "PT10H" "2 days" (2 * 86400 seconds) -> "PT48H"
Note that
- * multiples of 24 hours are not output as days to avoid confusion with {@code Period}.
+ * multiples of 24 hours are not output as days to avoid confusion with {@code Period} .
*
* @return
* an ISO-8601 representation of this duration, not null
diff --git a/core/shared/src/main/scala/org/threeten/bp/Instant.scala b/core/shared/src/main/scala/org/threeten/bp/Instant.scala
index 800b33d9e..4ea44fb92 100644
--- a/core/shared/src/main/scala/org/threeten/bp/Instant.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/Instant.scala
@@ -79,10 +79,10 @@ object Instant {
private def MILLIS_PER_SEC = 1000
/**
- * The minimum supported {@code Instant}, '-1000000000-01-01T00:00Z'. This could be used by an
+ * The minimum supported {@code Instant} , '-1000000000-01-01T00:00Z'. This could be used by an
* application as a "far past" instant.
*
- * This is one year earlier than the minimum {@code LocalDateTime}. This provides sufficient
+ * This is one year earlier than the minimum {@code LocalDateTime} . This provides sufficient
* values to handle the range of {@code ZoneOffset} which affect the instant in addition to the
* local date-time. The value is also chosen such that the value of the year fits in an {@code
* int}.
@@ -90,12 +90,12 @@ object Instant {
lazy val MIN: Instant = Instant.ofEpochSecond(MIN_SECOND, 0)
/**
- * The maximum supported {@code Instant}, '1000000000-12-31T23:59:59.999999999Z'. This could be
+ * The maximum supported {@code Instant} , '1000000000-12-31T23:59:59.999999999Z'. This could be
* used by an application as a "far future" instant.
*
- * This is one year later than the maximum {@code LocalDateTime}. This provides sufficient values
+ * This is one year later than the maximum {@code LocalDateTime} . This provides sufficient values
* to handle the range of {@code ZoneOffset} which affect the instant in addition to the local
- * date-time. The value is also chosen such that the value of the year fits in an {@code int}.
+ * date-time. The value is also chosen such that the value of the year fits in an {@code int} .
*/
lazy val MAX: Instant = Instant.ofEpochSecond(MAX_SECOND, 999999999)
@@ -118,7 +118,7 @@ object Instant {
* This will query the specified clock to obtain the current time.
*
* Using this method allows the use of an alternate clock for testing. The alternate clock may be
- * introduced using {@link Clock dependency injection}.
+ * introduced using {@link Clock dependency injection} .
*
* @param clock
* the clock to use, not null
@@ -195,20 +195,20 @@ object Instant {
* Obtains an instance of {@code Instant} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code Instant}.
+ * converts the arbitrary temporal object to an instance of {@code Instant} .
*
* The conversion extracts the {@link ChronoField#INSTANT_SECONDS INSTANT_SECONDS} and {@link
* ChronoField#NANO_OF_SECOND NANO_OF_SECOND} fields.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used as a query via method reference, {@code Instant::from}.
+ * to be used as a query via method reference, {@code Instant::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the instant, not null
* @throws DateTimeException
- * if unable to convert to an { @code Instant}
+ * if unable to convert to an {@code Instant}
*/
def from(temporal: TemporalAccessor): Instant =
try {
@@ -272,10 +272,10 @@ object Instant {
* event time-stamps in the application.
*
* For practicality, the instant is stored with some constraints. The measurable time-line is
- * restricted to the number of seconds that can be held in a {@code long}. This is greater than the
+ * restricted to the number of seconds that can be held in a {@code long} . This is greater than the
* current estimated age of the universe. The instant is stored to nanosecond resolution.
*
- * The range of an instant requires the storage of a number larger than a {@code long}. To achieve
+ * The range of an instant requires the storage of a number larger than a {@code long} . To achieve
* this, the class stores a {@code long} representing epoch-seconds and an {@code int} representing
* nanosecond-of-second, which will always be between 0 and 999,999,999. The epoch-seconds are
* measured from the standard Java epoch of {@code 1970-01-01T00:00:00Z} where instants after the
@@ -335,12 +335,12 @@ object Instant {
* 1/1000th longer or shorter than a real SI second.
*
* One final problem is the definition of the agreed international civil time before the
- * introduction of modern UTC in 1972. This includes the Java epoch of {@code 1970-01-01}. It is
+ * introduction of modern UTC in 1972. This includes the Java epoch of {@code 1970-01-01} . It is
* intended that instants before 1972 be interpreted based on the solar day divided into 86400
* subdivisions.
*
- * The Java time-scale is used by all date-time classes. This includes {@code Instant}, {@code
- * LocalDate}, {@code LocalTime}, {@code OffsetDateTime}, {@code ZonedDateTime} and {@code
+ * The Java time-scale is used by all date-time classes. This includes {@code Instant} , {@code
+ * LocalDate}, {@code LocalTime} , {@code OffsetDateTime} , {@code ZonedDateTime} and {@code
* Duration}.
*
* Specification for implementors
This class is immutable and thread-safe.
@@ -372,7 +372,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* are:
All other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -399,9 +399,9 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -415,7 +415,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
override def range(field: TemporalField): ValueRange = super.range(field)
/**
- * Gets the value of the specified field from this instant as an {@code int}.
+ * Gets the value of the specified field from this instant as an {@code int} .
*
* This queries this instant for the value for the specified field. The returned value will always
* be within the valid range of values for the field. If it is not possible to return the value,
@@ -427,7 +427,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* DateTimeException}. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -453,7 +453,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
}
/**
- * Gets the value of the specified field from this instant as a {@code long}.
+ * Gets the value of the specified field from this instant as a {@code long} .
*
* This queries this instant for the value for the specified field. If it is not possible to
* return the value, because the field is not supported or for some other reason, an exception is
@@ -461,9 +461,9 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this date-time.
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -493,7 +493,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* Gets the number of seconds from the Java epoch of 1970-01-01T00:00:00Z.
*
* The epoch second count is a simple incrementing count of seconds where second 0 is
- * 1970-01-01T00:00:00Z. The nanosecond part of the day is returned by {@code getNanosOfSecond}.
+ * 1970-01-01T00:00:00Z. The nanosecond part of the day is returned by {@code getNanosOfSecond} .
*
* @return
* the seconds from the epoch of 1970-01-01T00:00:00Z
@@ -504,7 +504,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* Gets the number of nanoseconds, later along the time-line, from the start of the second.
*
* The nanosecond-of-second value measures the total number of nanoseconds from the second
- * returned by {@code getEpochSecond}.
+ * returned by {@code getEpochSecond} .
*
* @return
* the nanoseconds within the second, always positive, never exceeds 999,999,999
@@ -514,7 +514,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
/**
* Returns an adjusted copy of this instant.
*
- * This returns a new {@code Instant}, based on this one, with the date adjusted. The adjustment
+ * This returns a new {@code Instant} , based on this one, with the date adjusted. The adjustment
* takes place using the specified adjuster strategy object. Read the documentation of the
* adjuster to understand what adjustment will be made.
*
@@ -527,7 +527,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param adjuster
* the adjuster to use, not null
* @return
- * an { @code Instant} based on { @code this} with the adjustment made, not null
+ * an {@code Instant} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -539,7 +539,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
/**
* Returns a copy of this instant with the specified field set to a new value.
*
- * This returns a new {@code Instant}, based on this one, with the value for the specified field
+ * This returns a new {@code Instant} , based on this one, with the value for the specified field
* changed. If it is not possible to set the value, because the field is not supported or for some
* other reason, an exception is thrown.
*
@@ -555,9 +555,9 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* In all cases, if the new value is outside the valid range of values for the field then a {@code
* DateTimeException} will be thrown.
*
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.adjustInto(Temporal, long)} passing {@code this} as the argument.
* In this case, the field determines whether and how to adjust the instant.
*
@@ -568,7 +568,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param newValue
* the new value of the field in the result
* @return
- * an { @code Instant} based on { @code this} with the specified field set, not null
+ * an {@code Instant} based on {@code this} with the specified field set, not null
* @throws DateTimeException
* if the field cannot be set
* @throws ArithmeticException
@@ -602,19 +602,19 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
*
* Truncating the instant returns a copy of the original with fields smaller than the specified
* unit set to zero. The fields are calculated on the basis of using a UTC offset as seen in
- * {@code toString}. For example, truncating with the {@link ChronoUnit#MINUTES MINUTES} unit will
- * round down to the nearest minute, setting the seconds and nanoseconds to zero.
+ * {@code toString} . For example, truncating with the {@link ChronoUnit#MINUTES MINUTES} unit
+ * will round down to the nearest minute, setting the seconds and nanoseconds to zero.
*
* The unit must have a {@linkplain TemporalUnit#getDuration() duration} that divides into the
* length of a standard day without remainder. This includes all supplied time units on {@link
- * ChronoUnit} and {@link ChronoUnit#DAYS DAYS}. Other units throw an exception.
+ * ChronoUnit} and {@link ChronoUnit#DAYS DAYS} . Other units throw an exception.
*
* This instance is immutable and unaffected by this method call.
*
* @param unit
* the unit to truncate to, not null
* @return
- * an { @code Instant} based on this instant with the time truncated, not null
+ * an {@code Instant} based on this instant with the time truncated, not null
* @throws DateTimeException
* if the unit is invalid for truncation
*/
@@ -636,18 +636,18 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
/**
* {@inheritDoc}
* @throws DateTimeException
- * { @inheritDoc}
+ * {@inheritDoc}
* @throws ArithmeticException
- * { @inheritDoc}
+ * {@inheritDoc}
*/
override def plus(amount: TemporalAmount): Instant = amount.addTo(this).asInstanceOf[Instant]
/**
* {@inheritDoc}
* @throws DateTimeException
- * { @inheritDoc}
+ * {@inheritDoc}
* @throws ArithmeticException
- * { @inheritDoc}
+ * {@inheritDoc}
*/
def plus(amountToAdd: Long, unit: TemporalUnit): Instant = {
unit match {
@@ -686,7 +686,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param secondsToAdd
* the seconds to add, positive or negative
* @return
- * an { @code Instant} based on this instant with the specified seconds added, not null
+ * an {@code Instant} based on this instant with the specified seconds added, not null
* @throws DateTimeException
* if the result exceeds the maximum or minimum instant
* @throws ArithmeticException
@@ -702,7 +702,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param millisToAdd
* the milliseconds to add, positive or negative
* @return
- * an { @code Instant} based on this instant with the specified milliseconds added, not null
+ * an {@code Instant} based on this instant with the specified milliseconds added, not null
* @throws DateTimeException
* if the result exceeds the maximum or minimum instant
* @throws ArithmeticException
@@ -719,7 +719,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param nanosToAdd
* the nanoseconds to add, positive or negative
* @return
- * an { @code Instant} based on this instant with the specified nanoseconds added, not null
+ * an {@code Instant} based on this instant with the specified nanoseconds added, not null
* @throws DateTimeException
* if the result exceeds the maximum or minimum instant
* @throws ArithmeticException
@@ -737,7 +737,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param nanosToAdd
* the nanos to add, positive or negative
* @return
- * an { @code Instant} based on this instant with the specified seconds added, not null
+ * an {@code Instant} based on this instant with the specified seconds added, not null
* @throws DateTimeException
* if the result exceeds the maximum or minimum instant
* @throws ArithmeticException
@@ -757,9 +757,9 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
/**
* {@inheritDoc}
* @throws DateTimeException
- * { @inheritDoc}
+ * {@inheritDoc}
* @throws ArithmeticException
- * { @inheritDoc}
+ * {@inheritDoc}
*/
override def minus(amount: TemporalAmount): Instant =
amount.subtractFrom(this).asInstanceOf[Instant]
@@ -767,9 +767,9 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
/**
* {@inheritDoc}
* @throws DateTimeException
- * { @inheritDoc}
+ * {@inheritDoc}
* @throws ArithmeticException
- * { @inheritDoc}
+ * {@inheritDoc}
*/
override def minus(amountToSubtract: Long, unit: TemporalUnit): Instant =
if (amountToSubtract == Long.MinValue) plus(Long.MaxValue, unit).plus(1, unit)
@@ -783,7 +783,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param secondsToSubtract
* the seconds to subtract, positive or negative
* @return
- * an { @code Instant} based on this instant with the specified seconds subtracted, not null
+ * an {@code Instant} based on this instant with the specified seconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the maximum or minimum instant
* @throws ArithmeticException
@@ -803,8 +803,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param millisToSubtract
* the milliseconds to subtract, positive or negative
* @return
- * an { @code Instant} based on this instant with the specified milliseconds subtracted, not
- * null
+ * an {@code Instant} based on this instant with the specified milliseconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the maximum or minimum instant
* @throws ArithmeticException
@@ -824,7 +823,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* @param nanosToSubtract
* the nanoseconds to subtract, positive or negative
* @return
- * an { @code Instant} based on this instant with the specified nanoseconds subtracted, not null
+ * an {@code Instant} based on this instant with the specified nanoseconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the maximum or minimum instant
* @throws ArithmeticException
@@ -903,28 +902,28 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* points are {@code this} and the specified instant. The result will be negative if the end is
* before the start. The calculation returns a whole number, representing the number of complete
* units between the two instants. The {@code Temporal} passed to this method is converted to a
- * {@code Instant} using {@link #from(TemporalAccessor)}. For example, the period in days between
- * two dates can be calculated using {@code startInstant.until(endInstant, SECONDS)}.
+ * {@code Instant} using {@link #from(TemporalAccessor)} . For example, the period in days between
+ * two dates can be calculated using {@code startInstant.until(endInstant, SECONDS)} .
*
- * This method operates in association with {@link TemporalUnit#between}. The result of this
+ * This method operates in association with {@link TemporalUnit#between} . The result of this
* method is a {@code long} representing the amount of the specified unit. By contrast, the result
* of {@code between} is an object that can be used directly in addition/subtraction: long
* period = start.until(end, SECONDS); // this method dateTime.plus(SECONDS.between(start, end));
* // use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code NANOS},
- * {@code MICROS}, {@code MILLIS}, {@code SECONDS}, {@code MINUTES}, {@code HOURS}, {@code
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code NANOS}
+ * , {@code MICROS} , {@code MILLIS} , {@code SECONDS} , {@code MINUTES} , {@code HOURS} , {@code
* HALF_DAYS} and {@code DAYS} are supported. Other {@code ChronoUnit} values will throw an
* exception.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end date, which is converted to an { @code Instant}, not null
+ * the end date, which is converted to an {@code Instant} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -981,7 +980,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
}
/**
- * Combines this instant with an offset to create an {@code OffsetDateTime}.
+ * Combines this instant with an offset to create an {@code OffsetDateTime} .
*
* This returns an {@code OffsetDateTime} formed from this instant at the specified offset from
* UTC/Greenwich. An exception will be thrown if the instant is too large to fit into an offset
@@ -1000,7 +999,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
def atOffset(offset: ZoneOffset): OffsetDateTime = OffsetDateTime.ofInstant(this, offset)
/**
- * Combines this instant with a time-zone to create a {@code ZonedDateTime}.
+ * Combines this instant with a time-zone to create a {@code ZonedDateTime} .
*
* This returns an {@code ZonedDateTime} formed from this instant at the specified time-zone. An
* exception will be thrown if the instant is too large to fit into a zoned date-time.
@@ -1054,7 +1053,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
* Compares this instant to the specified instant.
*
* The comparison is based on the time-line position of the instants. It is "consistent with
- * equals", as defined by {@link Comparable}.
+ * equals", as defined by {@link Comparable} .
*
* @param otherInstant
* the other instant to compare to, not null
@@ -1127,7 +1126,7 @@ final class Instant private (private val seconds: Long, private val nanos: Int)
/**
* A string representation of this instant using ISO-8601 representation.
*
- * The format used is the same as {@link DateTimeFormatter#ISO_INSTANT}.
+ * The format used is the same as {@link DateTimeFormatter#ISO_INSTANT} .
*
* @return
* an ISO-8601 representation of this instant, not null
diff --git a/core/shared/src/main/scala/org/threeten/bp/LocalDate.scala b/core/shared/src/main/scala/org/threeten/bp/LocalDate.scala
index c27f26473..06a0a2aa5 100644
--- a/core/shared/src/main/scala/org/threeten/bp/LocalDate.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/LocalDate.scala
@@ -69,13 +69,13 @@ import org.threeten.bp.zone.ZoneRules
object LocalDate {
/**
- * The minimum supported {@code LocalDate}, '-999999999-01-01'. This could be used by an
+ * The minimum supported {@code LocalDate} , '-999999999-01-01'. This could be used by an
* application as a "far past" date.
*/
lazy val MIN: LocalDate = LocalDate.of(Year.MIN_VALUE, 1, 1)
/**
- * The maximum supported {@code LocalDate}, '+999999999-12-31'. This could be used by an
+ * The maximum supported {@code LocalDate} , '+999999999-12-31'. This could be used by an
* application as a "far future" date.
*/
lazy val MAX: LocalDate = LocalDate.of(Year.MAX_VALUE, 12, 31)
@@ -124,7 +124,7 @@ object LocalDate {
*
* This will query the specified clock to obtain the current date - today. Using this method
* allows the use of an alternate clock for testing. The alternate clock may be introduced using
- * {@link Clock dependency injection}.
+ * {@link Clock dependency injection} .
*
* @param clock
* the clock to use, not null
@@ -263,20 +263,20 @@ object LocalDate {
* Obtains an instance of {@code LocalDate} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code LocalDate}.
+ * converts the arbitrary temporal object to an instance of {@code LocalDate} .
*
* The conversion uses the {@link TemporalQueries#localDate()} query, which relies on extracting
* the {@link ChronoField#EPOCH_DAY EPOCH_DAY} field.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used as a query via method reference, {@code LocalDate::from}.
+ * to be used as a query via method reference, {@code LocalDate::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the local date, not null
* @throws DateTimeException
- * if unable to convert to a { @code LocalDate}
+ * if unable to convert to a {@code LocalDate}
*/
def from(temporal: TemporalAccessor): LocalDate = {
val date: LocalDate = temporal.query(TemporalQueries.localDate)
@@ -288,7 +288,7 @@ object LocalDate {
}
/**
- * Obtains an instance of {@code LocalDate} from a text string such as {@code 2007-12-03}.
+ * Obtains an instance of {@code LocalDate} from a text string such as {@code 2007-12-03} .
*
* The string must represent a valid date and is parsed using {@link
* org.threeten.bp.format.DateTimeFormatter#ISO_LOCAL_DATE}.
@@ -376,11 +376,11 @@ object LocalDate {
}
/**
- * A date without a time-zone in the ISO-8601 calendar system, such as {@code 2007-12-03}.
+ * A date without a time-zone in the ISO-8601 calendar system, such as {@code 2007-12-03} .
*
* {@code LocalDate} is an immutable date-time object that represents a date, often viewed as
* year-month-day. Other date fields, such as day-of-year, day-of-week and week-of-year, can also be
- * accessed. For example, the value "2nd October 2007" can be stored in a {@code LocalDate}.
+ * accessed. For example, the value "2nd October 2007" can be stored in a {@code LocalDate} .
*
* This class does not store or represent a time or time-zone. Instead, it is a description of the
* date, as used for birthdays. It cannot represent an instant on the time-line without additional
@@ -431,7 +431,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
* import static
@@ -747,7 +747,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
* @param adjuster
* the adjuster to use, not null
* @return
- * a { @code LocalDate} based on { @code this} with the adjustment made, not null
+ * a {@code LocalDate} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -760,8 +760,8 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
/**
* Returns a copy of this date with the specified field set to a new value.
*
- * This returns a new {@code LocalDate}, based on this one, with the value for the specified field
- * changed. This can be used to change any supported field, such as the year, month or
+ * This returns a new {@code LocalDate} , based on this one, with the value for the specified
+ * field changed. This can be used to change any supported field, such as the year, month or
* day-of-month. If it is not possible to set the value, because the field is not supported or for
* some other reason, an exception is thrown.
*
@@ -787,7 +787,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
* {@code LocalDate} with the specified day-of-year. The year will be unchanged. If the
* day-of-year is invalid for the year, then a {@code DateTimeException} is thrown.
long
* period = start.until(end, MONTHS); // this method dateTime.plus(MONTHS.between(start, end)); //
* use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code DAYS},
- * {@code WEEKS}, {@code MONTHS}, {@code YEARS}, {@code DECADES}, {@code CENTURIES}, {@code
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code DAYS} ,
+ * {@code WEEKS} , {@code MONTHS} , {@code YEARS} , {@code DECADES} , {@code CENTURIES} , {@code
* MILLENNIA} and {@code ERAS} are supported. Other {@code ChronoUnit} values will throw an
* exception.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end date, which is converted to a { @code LocalDate}, not null
+ * the end date, which is converted to a {@code LocalDate} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -1362,7 +1362,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
}
/**
- * Calculates the period between this date and another date as a {@code Period}.
+ * Calculates the period between this date and another date as a {@code Period} .
*
* This calculates the period between two dates in terms of years, months and days. The start and
* end points are {@code this} and the specified date. The result will be negative if the end is
@@ -1382,7 +1382,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
* sign will be the same in each of year, month and day.
*
* There are two equivalent ways of using this method. The first is to invoke this method. The
- * second is to use {@link Period#between(LocalDate, LocalDate)}: // these two lines are
+ * second is to use {@link Period#between(LocalDate, LocalDate)} :
*
* This method only considers the position of the two dates on the local time-line. It does not
* take into account the chronology, or calendar system. This is different from the comparison in
- * {@link #compareTo(ChronoLocalDate)}, but is the same approach as {@link #DATE_COMPARATOR}.
+ * {@link #compareTo(ChronoLocalDate)} , but is the same approach as {@link #DATE_COMPARATOR} .
*
* @param other
* the other date to compare to, not null
@@ -1619,12 +1618,11 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
*
* This checks to see if this date represents a point on the local time-line before the other
* date. // these two lines are
* equivalent period = start.until(end); period = Period.between(start, end);
The choice
* should be made based on which makes the code more readable.
*
@@ -1409,7 +1409,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
}
/**
- * Combines this date with a time to create a {@code LocalDateTime}.
+ * Combines this date with a time to create a {@code LocalDateTime} .
*
* This returns a {@code LocalDateTime} formed from this date at the specified time. All possible
* combinations of date and time are valid.
@@ -1422,7 +1422,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
override def atTime(time: LocalTime): LocalDateTime = LocalDateTime.of(this, time)
/**
- * Combines this date with a time to create a {@code LocalDateTime}.
+ * Combines this date with a time to create a {@code LocalDateTime} .
*
* This returns a {@code LocalDateTime} formed from this date at the specified hour and minute.
* The seconds and nanosecond fields will be set to zero. The individual time fields must be
@@ -1440,7 +1440,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
def atTime(hour: Int, minute: Int): LocalDateTime = atTime(LocalTime.of(hour, minute))
/**
- * Combines this date with a time to create a {@code LocalDateTime}.
+ * Combines this date with a time to create a {@code LocalDateTime} .
*
* This returns a {@code LocalDateTime} formed from this date at the specified hour, minute and
* second. The nanosecond field will be set to zero. The individual time fields must be within
@@ -1461,7 +1461,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
atTime(LocalTime.of(hour, minute, second))
/**
- * Combines this date with a time to create a {@code LocalDateTime}.
+ * Combines this date with a time to create a {@code LocalDateTime} .
*
* This returns a {@code LocalDateTime} formed from this date at the specified hour, minute,
* second and nanosecond. The individual time fields must be within their valid range. All
@@ -1484,7 +1484,7 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
atTime(LocalTime.of(hour, minute, second, nanoOfSecond))
/**
- * Combines this date with an offset time to create an {@code OffsetDateTime}.
+ * Combines this date with an offset time to create an {@code OffsetDateTime} .
*
* This returns an {@code OffsetDateTime} formed from this date at the specified time. All
* possible combinations of date and time are valid.
@@ -1523,10 +1523,10 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
* of midnight on the date. In the case of a gap, the zoned date-time will represent the instant
* just after the gap.
*
- * If the zone ID is a {@link ZoneOffset}, then the result always has a time of midnight.
+ * If the zone ID is a {@link ZoneOffset} , then the result always has a time of midnight.
*
* To convert to a specific time in a given time-zone call {@link #atTime(LocalTime)} followed by
- * {@link LocalDateTime#atZone(ZoneId)}.
+ * {@link LocalDateTime#atZone(ZoneId)} .
*
* @param zone
* the zone ID to use, not null
@@ -1568,11 +1568,11 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
* Compares this date to another date.
*
* The comparison is primarily based on the date, from earliest to latest. It is "consistent with
- * equals", as defined by {@link Comparable}.
+ * equals", as defined by {@link Comparable} .
*
- * If all the dates being compared are instances of {@code LocalDate}, then the comparison will be
- * entirely based on the date. If some dates being compared are in different chronologies, then
- * the chronology is also considered, see {@link ChronoLocalDate#compareTo}.
+ * If all the dates being compared are instances of {@code LocalDate} , then the comparison will
+ * be entirely based on the date. If some dates being compared are in different chronologies, then
+ * the chronology is also considered, see {@link ChronoLocalDate#compareTo} .
*
* @param other
* the other date to compare to, not null
@@ -1598,12 +1598,11 @@ final class LocalDate private (private val year: Int, monthOfYear: Int, dayOfMon
*
* This checks to see if this date represents a point on the local time-line after the other date.
* LocalDate a = LocalDate.of(2012, 6, 30); LocalDate b = LocalDate.of(2012, 7, 1);
- * a.isAfter(b) == false
- * a.isAfter(a) == false b.isAfter(a) == true
+ * a.isAfter(b) == false a.isAfter(a) == false b.isAfter(a) == true LocalDate a = LocalDate.of(2012, 6, 30); LocalDate b = LocalDate.of(2012, 7, 1);
- * a.isBefore(b) == true
- * a.isBefore(a) == false b.isBefore(a) == false
+ * a.isBefore(b) == true a.isBefore(a) == false b.isBefore(a) == false LocalDate a = LocalDate.of(2012, 6, 30); LocalDate b = LocalDate.of(2012, 7, 1);
- * a.isEqual(b) == false
- * a.isEqual(a) == true b.isEqual(a) == false
+ * a.isEqual(b) == false a.isEqual(a) == true b.isEqual(a) == false import static
@@ -810,7 +810,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
*
* result = localDateTime.with(JULY).with(lastDayOfMonth());
*
- * The classes {@link LocalDate} and {@link LocalTime} implement {@code TemporalAdjuster}, thus
+ * The classes {@link LocalDate} and {@link LocalTime} implement {@code TemporalAdjuster} , thus
* this method can be used to change the date, time or offset: result =
* localDateTime.with(date); result = localDateTime.with(time);
*
@@ -823,7 +823,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param adjuster
* the adjuster to use, not null
* @return
- * a { @code LocalDateTime} based on { @code this} with the adjustment made, not null
+ * a {@code LocalDateTime} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -841,7 +841,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
/**
* Returns a copy of this date-time with the specified field set to a new value.
*
- * This returns a new {@code LocalDateTime}, based on this one, with the value for the specified
+ * This returns a new {@code LocalDateTime} , based on this one, with the value for the specified
* field changed. This can be used to change any supported field, such as the year, month or
* day-of-month. If it is not possible to set the value, because the field is not supported or for
* some other reason, an exception is thrown.
@@ -854,9 +854,9 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* If the field is a {@link ChronoField} then the adjustment is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will behave as per the matching method on {@link
* LocalDate#with(TemporalField, long) LocalDate} or {@link LocalTime#with(TemporalField, long)
- * LocalTime}. All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * LocalTime}. All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.adjustInto(Temporal, long)} passing {@code this} as the argument.
* In this case, the field determines whether and how to adjust the instant.
*
@@ -867,7 +867,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param newValue
* the new value of the field in the result
* @return
- * a { @code LocalDateTime} based on { @code this} with the specified field set, not null
+ * a {@code LocalDateTime} based on {@code this} with the specified field set, not null
* @throws DateTimeException
* if the field cannot be set
* @throws ArithmeticException
@@ -891,7 +891,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param year
* the year to set in the result, from MIN_YEAR to MAX_YEAR
* @return
- * a { @code LocalDateTime} based on this date-time with the requested year, not null
+ * a {@code LocalDateTime} based on this date-time with the requested year, not null
* @throws DateTimeException
* if the year value is invalid
*/
@@ -907,7 +907,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param month
* the month-of-year to set in the result, from 1 (January) to 12 (December)
* @return
- * a { @code LocalDateTime} based on this date-time with the requested month, not null
+ * a {@code LocalDateTime} based on this date-time with the requested month, not null
* @throws DateTimeException
* if the month-of-year value is invalid
*/
@@ -923,7 +923,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param dayOfMonth
* the day-of-month to set in the result, from 1 to 28-31
* @return
- * a { @code LocalDateTime} based on this date-time with the requested day, not null
+ * a {@code LocalDateTime} based on this date-time with the requested day, not null
* @throws DateTimeException
* if the day-of-month value is invalid
* @throws DateTimeException
@@ -940,7 +940,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param dayOfYear
* the day-of-year to set in the result, from 1 to 365-366
* @return
- * a { @code LocalDateTime} based on this date with the requested day, not null
+ * a {@code LocalDateTime} based on this date with the requested day, not null
* @throws DateTimeException
* if the day-of-year value is invalid
* @throws DateTimeException
@@ -956,7 +956,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param hour
* the hour-of-day to set in the result, from 0 to 23
* @return
- * a { @code LocalDateTime} based on this date-time with the requested hour, not null
+ * a {@code LocalDateTime} based on this date-time with the requested hour, not null
* @throws DateTimeException
* if the hour value is invalid
*/
@@ -971,7 +971,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param minute
* the minute-of-hour to set in the result, from 0 to 59
* @return
- * a { @code LocalDateTime} based on this date-time with the requested minute, not null
+ * a {@code LocalDateTime} based on this date-time with the requested minute, not null
* @throws DateTimeException
* if the minute value is invalid
*/
@@ -988,7 +988,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param second
* the second-of-minute to set in the result, from 0 to 59
* @return
- * a { @code LocalDateTime} based on this date-time with the requested second, not null
+ * a {@code LocalDateTime} based on this date-time with the requested second, not null
* @throws DateTimeException
* if the second value is invalid
*/
@@ -1005,7 +1005,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param nanoOfSecond
* the nano-of-second to set in the result, from 0 to 999,999,999
* @return
- * a { @code LocalDateTime} based on this date-time with the requested nanosecond, not null
+ * a {@code LocalDateTime} based on this date-time with the requested nanosecond, not null
* @throws DateTimeException
* if the nano value is invalid
*/
@@ -1023,14 +1023,14 @@ final class LocalDateTime private (private val date: LocalDate, private val time
*
* The unit must have a {@linkplain TemporalUnit#getDuration() duration} that divides into the
* length of a standard day without remainder. This includes all supplied time units on {@link
- * ChronoUnit} and {@link ChronoUnit#DAYS DAYS}. Other units throw an exception.
+ * ChronoUnit} and {@link ChronoUnit#DAYS DAYS} . Other units throw an exception.
*
* This instance is immutable and unaffected by this method call.
*
* @param unit
* the unit to truncate to, not null
* @return
- * a { @code LocalDateTime} based on this date-time with the time truncated, not null
+ * a {@code LocalDateTime} based on this date-time with the time truncated, not null
* @throws DateTimeException
* if unable to truncate
*/
@@ -1042,14 +1042,14 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* This method returns a new date-time based on this time with the specified period added. The
* amount is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #plus(long, TemporalUnit)}.
+ * typically calls back to {@link #plus(long, TemporalUnit)} .
*
* This instance is immutable and unaffected by this method call.
*
* @param amount
* the amount to add, not null
* @return
- * a { @code LocalDateTime} based on this date-time with the addition made, not null
+ * a {@code LocalDateTime} based on this date-time with the addition made, not null
* @throws DateTimeException
* if the addition cannot be made
* @throws ArithmeticException
@@ -1073,7 +1073,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param unit
* the unit of the period to add, not null
* @return
- * a { @code LocalDateTime} based on this date-time with the specified period added, not null
+ * a {@code LocalDateTime} based on this date-time with the specified period added, not null
* @throws DateTimeException
* if the unit cannot be added to this type
*/
@@ -1114,7 +1114,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param years
* the years to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the years added, not null
+ * a {@code LocalDateTime} based on this date-time with the years added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1138,7 +1138,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param months
* the months to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the months added, not null
+ * a {@code LocalDateTime} based on this date-time with the months added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1161,7 +1161,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param weeks
* the weeks to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the weeks added, not null
+ * a {@code LocalDateTime} based on this date-time with the weeks added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1184,7 +1184,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param days
* the days to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the days added, not null
+ * a {@code LocalDateTime} based on this date-time with the days added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1201,7 +1201,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param hours
* the hours to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the hours added, not null
+ * a {@code LocalDateTime} based on this date-time with the hours added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1215,7 +1215,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param minutes
* the minutes to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the minutes added, not null
+ * a {@code LocalDateTime} based on this date-time with the minutes added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1229,7 +1229,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param seconds
* the seconds to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the seconds added, not null
+ * a {@code LocalDateTime} based on this date-time with the seconds added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1243,7 +1243,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param nanos
* the nanos to add, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the nanoseconds added, not null
+ * a {@code LocalDateTime} based on this date-time with the nanoseconds added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1255,14 +1255,14 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* This method returns a new date-time based on this time with the specified period subtracted.
* The amount is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #minus(long, TemporalUnit)}.
+ * typically calls back to {@link #minus(long, TemporalUnit)} .
*
* This instance is immutable and unaffected by this method call.
*
* @param amount
* the amount to subtract, not null
* @return
- * a { @code LocalDateTime} based on this date-time with the subtraction made, not null
+ * a {@code LocalDateTime} based on this date-time with the subtraction made, not null
* @throws DateTimeException
* if the subtraction cannot be made
* @throws ArithmeticException
@@ -1286,7 +1286,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param unit
* the unit of the period to subtract, not null
* @return
- * a { @code LocalDateTime} based on this date-time with the specified period subtracted, not
+ * a {@code LocalDateTime} based on this date-time with the specified period subtracted, not
* null
* @throws DateTimeException
* if the unit cannot be added to this type
@@ -1311,7 +1311,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param years
* the years to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the years subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the years subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1334,7 +1334,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param months
* the months to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the months subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the months subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1356,7 +1356,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param weeks
* the weeks to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the weeks subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the weeks subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1378,7 +1378,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param days
* the days to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the days subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the days subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1394,7 +1394,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param hours
* the hours to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the hours subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the hours subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1408,7 +1408,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param minutes
* the minutes to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the minutes subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the minutes subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1422,7 +1422,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param seconds
* the seconds to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the seconds subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the seconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1437,7 +1437,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* @param nanos
* the nanos to subtract, may be negative
* @return
- * a { @code LocalDateTime} based on this date-time with the nanoseconds subtracted, not null
+ * a {@code LocalDateTime} based on this date-time with the nanoseconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1545,7 +1545,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
*
* This calculates the period between two date-times in terms of a single unit. The start and end
* points are {@code this} and the specified date-time. The result will be negative if the end is
- * before the start. The {@code Temporal} passed to this method must be a {@code LocalDateTime}.
+ * before the start. The {@code Temporal} passed to this method must be a {@code LocalDateTime} .
* For example, the period in days between two date-times can be calculated using {@code
* startDateTime.until(endDateTime, DAYS)}.
*
@@ -1553,26 +1553,26 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* two date-times. For example, the period in months between 2012-06-15T00:00 and 2012-08-14T23:59
* will only be one month as it is one minute short of two months.
*
- * This method operates in association with {@link TemporalUnit#between}. The result of this
+ * This method operates in association with {@link TemporalUnit#between} . The result of this
* method is a {@code long} representing the amount of the specified unit. By contrast, the result
* of {@code between} is an object that can be used directly in addition/subtraction: long
* period = start.until(end, MONTHS); // this method dateTime.plus(MONTHS.between(start, end)); //
* use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code NANOS},
- * {@code MICROS}, {@code MILLIS}, {@code SECONDS}, {@code MINUTES}, {@code HOURS} and {@code
- * HALF_DAYS}, {@code DAYS}, {@code WEEKS}, {@code MONTHS}, {@code YEARS}, {@code DECADES}, {@code
- * CENTURIES}, {@code MILLENNIA} and {@code ERAS} are supported. Other {@code ChronoUnit} values
- * will throw an exception.
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code NANOS}
+ * , {@code MICROS} , {@code MILLIS} , {@code SECONDS} , {@code MINUTES} , {@code HOURS} and
+ * {@code HALF_DAYS}, {@code DAYS} , {@code WEEKS} , {@code MONTHS} , {@code YEARS} ,
+ * {@code DECADES} , {@code CENTURIES}, {@code MILLENNIA} and {@code ERAS} are supported. Other
+ * {@code ChronoUnit} values will throw an exception.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end date-time, which is converted to a { @code LocalDateTime}, not null
+ * the end date-time, which is converted to a {@code LocalDateTime} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -1641,7 +1641,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
}
/**
- * Combines this date-time with an offset to create an {@code OffsetDateTime}.
+ * Combines this date-time with an offset to create an {@code OffsetDateTime} .
*
* This returns an {@code OffsetDateTime} formed from this date-time at the specified offset. All
* possible combinations of date-time and offset are valid.
@@ -1654,7 +1654,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
def atOffset(offset: ZoneOffset): OffsetDateTime = OffsetDateTime.of(this, offset)
/**
- * Combines this date-time with a time-zone to create a {@code ZonedDateTime}.
+ * Combines this date-time with a time-zone to create a {@code ZonedDateTime} .
*
* This returns a {@code ZonedDateTime} formed from this date-time at the specified time-zone. The
* result will match this date-time as closely as possible. Time-zone rules, such as daylight
@@ -1709,9 +1709,9 @@ final class LocalDateTime private (private val date: LocalDate, private val time
* Compares this date-time to another date-time.
*
* The comparison is primarily based on the date-time, from earliest to latest. It is "consistent
- * with equals", as defined by {@link Comparable}.
+ * with equals", as defined by {@link Comparable} .
*
- * If all the date-times being compared are instances of {@code LocalDateTime}, then the
+ * If all the date-times being compared are instances of {@code LocalDateTime} , then the
* comparison will be entirely based on the date-time. If some dates being compared are in
* different chronologies, then the chronology is also considered, see {@link
* ChronoLocalDateTime#compareTo}.
@@ -1739,13 +1739,12 @@ final class LocalDateTime private (private val date: LocalDate, private val time
*
* This checks to see if this date-time represents a point on the local time-line after the other
* date-time. LocalDate a = LocalDateTime.of(2012, 6, 30, 12, 00); LocalDate b =
- * LocalDateTime.of(2012, 7, 1, 12, 00);
- * a.isAfter(b) == false
- * a.isAfter(a) == false b.isAfter(a) == true
+ * LocalDateTime.of(2012, 7, 1, 12, 00); a.isAfter(b) == false a.isAfter(a) == false b.isAfter(a)
+ * \== true
*
* This method only considers the position of the two date-times on the local time-line. It does
* not take into account the chronology, or calendar system. This is different from the comparison
- * in {@link #compareTo(ChronoLocalDateTime)}, but is the same approach as {@link
+ * in {@link #compareTo(ChronoLocalDateTime)} , but is the same approach as {@link
* #DATE_TIME_COMPARATOR}.
*
* @param other
@@ -1764,13 +1763,12 @@ final class LocalDateTime private (private val date: LocalDate, private val time
*
* This checks to see if this date-time represents a point on the local time-line before the other
* date-time. LocalDate a = LocalDateTime.of(2012, 6, 30, 12, 00); LocalDate b =
- * LocalDateTime.of(2012, 7, 1, 12, 00);
- * a.isBefore(b) == true
- * a.isBefore(a) == false b.isBefore(a) == false
+ * LocalDateTime.of(2012, 7, 1, 12, 00); a.isBefore(b) == true a.isBefore(a) == false
+ * b.isBefore(a) == false
*
* This method only considers the position of the two date-times on the local time-line. It does
* not take into account the chronology, or calendar system. This is different from the comparison
- * in {@link #compareTo(ChronoLocalDateTime)}, but is the same approach as {@link
+ * in {@link #compareTo(ChronoLocalDateTime)} , but is the same approach as {@link
* #DATE_TIME_COMPARATOR}.
*
* @param other
@@ -1789,13 +1787,12 @@ final class LocalDateTime private (private val date: LocalDate, private val time
*
* This checks to see if this date-time represents the same point on the local time-line as the
* other date-time. LocalDate a = LocalDateTime.of(2012, 6, 30, 12, 00); LocalDate b =
- * LocalDateTime.of(2012, 7, 1, 12, 00);
- * a.isEqual(b) == false
- * a.isEqual(a) == true b.isEqual(a) == false
+ * LocalDateTime.of(2012, 7, 1, 12, 00); a.isEqual(b) == false a.isEqual(a) == true b.isEqual(a)
+ * \== false
*
* This method only considers the position of the two date-times on the local time-line. It does
* not take into account the chronology, or calendar system. This is different from the comparison
- * in {@link #compareTo(ChronoLocalDateTime)}, but is the same approach as {@link
+ * in {@link #compareTo(ChronoLocalDateTime)} , but is the same approach as {@link
* #DATE_TIME_COMPARATOR}.
*
* @param other
@@ -1835,7 +1832,7 @@ final class LocalDateTime private (private val date: LocalDate, private val time
override def hashCode: Int = date.hashCode ^ time.hashCode
/**
- * Outputs this date-time as a {@code String}, such as {@code 2007-12-03T10:15:30}.
+ * Outputs this date-time as a {@code String} , such as {@code 2007-12-03T10:15:30} .
*
* The output will be one of the following ISO-8601 formats:
All other {@code ChronoField}
* instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -502,9 +502,9 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -518,7 +518,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
override def range(field: TemporalField): ValueRange = super.range(field)
/**
- * Gets the value of the specified field from this time as an {@code int}.
+ * Gets the value of the specified field from this time as an {@code int} .
*
* This queries this time for the value for the specified field. The returned value will always be
* within the valid range of values for the field. If it is not possible to return the value,
@@ -527,10 +527,10 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this time,
* except {@code NANO_OF_DAY} and {@code MICRO_OF_DAY} which are too large to fit in an {@code
- * int} and throw a {@code DateTimeException}. All other {@code ChronoField} instances will throw
- * a {@code DateTimeException}.
+ * int} and throw a {@code DateTimeException} . All other {@code ChronoField} instances will throw
+ * a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -548,16 +548,16 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
else super.get(field)
/**
- * Gets the value of the specified field from this time as a {@code long}.
+ * Gets the value of the specified field from this time as a {@code long} .
*
* This queries this time for the value for the specified field. If it is not possible to return
* the value, because the field is not supported or for some other reason, an exception is thrown.
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this time. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -637,9 +637,9 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
/**
* Returns an adjusted copy of this time.
*
- * This returns a new {@code LocalTime}, based on this one, with the time adjusted. The adjustment
- * takes place using the specified adjuster strategy object. Read the documentation of the
- * adjuster to understand what adjustment will be made.
+ * This returns a new {@code LocalTime} , based on this one, with the time adjusted. The
+ * adjustment takes place using the specified adjuster strategy object. Read the documentation of
+ * the adjuster to understand what adjustment will be made.
*
* A simple adjuster might simply set the one of the fields, such as the hour field. A more
* complex adjuster might set the time to the last hour of the day.
@@ -653,7 +653,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
* @param adjuster
* the adjuster to use, not null
* @return
- * a { @code LocalTime} based on { @code this} with the adjustment made, not null
+ * a {@code LocalTime} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -668,16 +668,16 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
/**
* Returns a copy of this time with the specified field set to a new value.
*
- * This returns a new {@code LocalTime}, based on this one, with the value for the specified field
- * changed. This can be used to change any supported field, such as the hour, minute or second. If
- * it is not possible to set the value, because the field is not supported or for some other
- * reason, an exception is thrown.
+ * This returns a new {@code LocalTime} , based on this one, with the value for the specified
+ * field changed. This can be used to change any supported field, such as the hour, minute or
+ * second. If it is not possible to set the value, because the field is not supported or for some
+ * other reason, an exception is thrown.
*
* If the field is a {@link ChronoField} then the adjustment is implemented here. The supported
* fields behave as follows:
long
* period = start.until(end, HOURS); // this method dateTime.plus(HOURS.between(start, end)); //
* use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code NANOS},
- * {@code MICROS}, {@code MILLIS}, {@code SECONDS}, {@code MINUTES}, {@code HOURS} and {@code
- * HALF_DAYS} are supported. Other {@code ChronoUnit} values will throw an exception.
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code NANOS}
+ * , {@code MICROS} , {@code MILLIS} , {@code SECONDS} , {@code MINUTES} , {@code HOURS} and
+ * {@code HALF_DAYS} are supported. Other {@code ChronoUnit} values will throw an exception.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end time, which is converted to a { @code LocalTime}, not null
+ * the end time, which is converted to a {@code LocalTime} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -1260,7 +1260,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
}
/**
- * Combines this time with a date to create a {@code LocalDateTime}.
+ * Combines this time with a date to create a {@code LocalDateTime} .
*
* This returns a {@code LocalDateTime} formed from this time at the specified date. All possible
* combinations of date and time are valid.
@@ -1273,7 +1273,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
def atDate(date: LocalDate): LocalDateTime = LocalDateTime.of(date, this)
/**
- * Combines this time with an offset to create an {@code OffsetTime}.
+ * Combines this time with an offset to create an {@code OffsetTime} .
*
* This returns an {@code OffsetTime} formed from this time at the specified offset. All possible
* combinations of time and offset are valid.
@@ -1286,7 +1286,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
def atOffset(offset: ZoneOffset): OffsetTime = OffsetTime.of(this, offset)
/**
- * Extracts the time as seconds of day, from {@code 0} to {@code 24 * 60 * 60 - 1}.
+ * Extracts the time as seconds of day, from {@code 0} to {@code 24 * 60 * 60 - 1} .
*
* @return
* the second-of-day equivalent to this time
@@ -1299,7 +1299,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
}
/**
- * Extracts the time as nanos of day, from {@code 0} to {@code 24 * 60 * 60 * 1,000,000,000 - 1}.
+ * Extracts the time as nanos of day, from {@code 0} to {@code 24 * 60 * 60 * 1,000,000,000 - 1} .
*
* @return
* the nano of day equivalent to this time
@@ -1316,14 +1316,14 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
* Compares this {@code LocalTime} to another time.
*
* The comparison is based on the time-line position of the local times within a day. It is
- * "consistent with equals", as defined by {@link Comparable}.
+ * "consistent with equals", as defined by {@link Comparable} .
*
* @param other
* the other time to compare to, not null
* @return
* the comparator value, negative if less, positive if greater
* @throws NullPointerException
- * if { @code other} is null
+ * if {@code other} is null
*/
def compare(other: LocalTime): Int = {
var cmp: Int = Integer.compare(hour.toInt, other.hour.toInt)
@@ -1350,7 +1350,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
* @return
* true if this is after the specified time
* @throws NullPointerException
- * if { @code other} is null
+ * if {@code other} is null
*/
def isAfter(other: LocalTime): Boolean = compareTo(other) > 0
@@ -1364,7 +1364,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
* @return
* true if this point is before the specified time
* @throws NullPointerException
- * if { @code other} is null
+ * if {@code other} is null
*/
def isBefore(other: LocalTime): Boolean = compareTo(other) < 0
@@ -1401,7 +1401,7 @@ final class LocalTime(_hour: Int, _minute: Int, _second: Int, private val nano:
}
/**
- * Outputs this time as a {@code String}, such as {@code 10:15}.
+ * Outputs this time as a {@code String} , such as {@code 10:15} .
*
* The output will be one of the following ISO-8601 formats:
* All other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -435,9 +435,9 @@ final class OffsetDateTime private (
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -456,7 +456,7 @@ final class OffsetDateTime private (
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this date-time as an {@code int}.
+ * Gets the value of the specified field from this date-time as an {@code int} .
*
* This queries this date-time for the value for the specified field. The returned value will
* always be within the valid range of values for the field. If it is not possible to return the
@@ -464,12 +464,12 @@ final class OffsetDateTime private (
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this date-time,
- * except {@code NANO_OF_DAY}, {@code MICRO_OF_DAY}, {@code EPOCH_DAY}, {@code EPOCH_MONTH} and
+ * except {@code NANO_OF_DAY} , {@code MICRO_OF_DAY} , {@code EPOCH_DAY} , {@code EPOCH_MONTH} and
* {@code INSTANT_SECONDS} which are too large to fit in an {@code int} and throw a {@code
* DateTimeException}. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -495,7 +495,7 @@ final class OffsetDateTime private (
}
/**
- * Gets the value of the specified field from this date-time as a {@code long}.
+ * Gets the value of the specified field from this date-time as a {@code long} .
*
* This queries this date-time for the value for the specified field. If it is not possible to
* return the value, because the field is not supported or for some other reason, an exception is
@@ -503,9 +503,9 @@ final class OffsetDateTime private (
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this date-time.
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -546,8 +546,8 @@ final class OffsetDateTime private (
*
* This method returns an object with the same {@code LocalDateTime} and the specified {@code
* ZoneOffset}. No calculation is needed or performed. For example, if this time represents {@code
- * 2007-12-03T10:30+02:00} and the offset specified is {@code +03:00}, then this method will
- * return {@code 2007-12-03T10:30+03:00}.
+ * 2007-12-03T10:30+02:00} and the offset specified is {@code +03:00} , then this method will
+ * return {@code 2007-12-03T10:30+03:00} .
*
* To take into account the difference between the offsets, and adjust the time fields, use {@link
* #withOffsetSameInstant}.
@@ -557,7 +557,7 @@ final class OffsetDateTime private (
* @param offset
* the zone offset to change to, not null
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested offset, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested offset, not null
*/
def withOffsetSameLocal(offset: ZoneOffset): OffsetDateTime = `with`(dateTime, offset)
@@ -569,16 +569,16 @@ final class OffsetDateTime private (
* adjusted by the difference between the two offsets. This will result in the old and new objects
* representing the same instant. This is useful for finding the local time in a different offset.
* For example, if this time represents {@code 2007-12-03T10:30+02:00} and the offset specified is
- * {@code +03:00}, then this method will return {@code 2007-12-03T11:30+03:00}.
+ * {@code +03:00} , then this method will return {@code 2007-12-03T11:30+03:00} .
*
- * To change the offset without adjusting the local time use {@link #withOffsetSameLocal}.
+ * To change the offset without adjusting the local time use {@link #withOffsetSameLocal} .
*
* This instance is immutable and unaffected by this method call.
*
* @param offset
* the zone offset to change to, not null
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested offset, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested offset, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -595,8 +595,8 @@ final class OffsetDateTime private (
*
* This method returns the primitive {@code int} value for the year.
*
- * The year returned by this method is proleptic as per {@code get(YEAR)}. To obtain the
- * year-of-era, use {@code get(YEAR_OF_ERA}.
+ * The year returned by this method is proleptic as per {@code get(YEAR)} . To obtain the
+ * year-of-era, use {@code get(YEAR_OF_ERA} .
*
* @return
* the year, from MIN_YEAR to MAX_YEAR
@@ -607,7 +607,7 @@ final class OffsetDateTime private (
* Gets the month-of-year field from 1 to 12.
*
* This method returns the month as an {@code int} from 1 to 12. Application code is frequently
- * clearer if the enum {@link Month} is used by calling {@link #getMonth()}.
+ * clearer if the enum {@link Month} is used by calling {@link #getMonth()} .
*
* @return
* the month-of-year, from 1 to 12
@@ -621,7 +621,7 @@ final class OffsetDateTime private (
*
* This method returns the enum {@link Month} for the month. This avoids confusion as to what
* {@code int} values mean. If you need access to the primitive {@code int} value then the enum
- * provides the {@link Month#getValue() int value}.
+ * provides the {@link Month#getValue() int value} .
*
* @return
* the month-of-year, not null
@@ -651,13 +651,13 @@ final class OffsetDateTime private (
def getDayOfYear: Int = dateTime.getDayOfYear
/**
- * Gets the day-of-week field, which is an enum {@code DayOfWeek}.
+ * Gets the day-of-week field, which is an enum {@code DayOfWeek} .
*
* This method returns the enum {@link DayOfWeek} for the day-of-week. This avoids confusion as to
* what {@code int} values mean. If you need access to the primitive {@code int} value then the
- * enum provides the {@link DayOfWeek#getValue() int value}.
+ * enum provides the {@link DayOfWeek#getValue() int value} .
*
- * Additional information can be obtained from the {@code DayOfWeek}. This includes textual names
+ * Additional information can be obtained from the {@code DayOfWeek} . This includes textual names
* of the values.
*
* @return
@@ -700,15 +700,15 @@ final class OffsetDateTime private (
/**
* Returns an adjusted copy of this date-time.
*
- * This returns a new {@code OffsetDateTime}, based on this one, with the date-time adjusted. The
+ * This returns a new {@code OffsetDateTime} , based on this one, with the date-time adjusted. The
* adjustment takes place using the specified adjuster strategy object. Read the documentation of
* the adjuster to understand what adjustment will be made.
*
* A simple adjuster might simply set the one of the fields, such as the year field. A more
* complex adjuster might set the date to the last day of the month. A selection of common
- * adjustments is provided in {@link TemporalAdjusters}. These include finding the "last day of
+ * adjustments is provided in {@link TemporalAdjusters} . These include finding the "last day of
* the month" and "next Wednesday". Key date-time classes also implement the {@code
- * TemporalAdjuster} interface, such as {@link Month} and {@link MonthDay}. The adjuster is
+ * TemporalAdjuster} interface, such as {@link Month} and {@link MonthDay} . The adjuster is
* responsible for handling special cases, such as the varying lengths of month and leap years.
*
* For example this code returns a date on the last day of July:
All other
* {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -317,9 +317,9 @@ final class MonthDay private (private val month: Int, private val day: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -342,7 +342,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this month-day as an {@code int}.
+ * Gets the value of the specified field from this month-day as an {@code int} .
*
* This queries this month-day for the value for the specified field. The returned value will
* always be within the valid range of values for the field. If it is not possible to return the
@@ -350,9 +350,9 @@ final class MonthDay private (private val month: Int, private val day: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this month-day.
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -369,7 +369,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
range(field).checkValidIntValue(getLong(field), field)
/**
- * Gets the value of the specified field from this month-day as a {@code long}.
+ * Gets the value of the specified field from this month-day as a {@code long} .
*
* This queries this month-day for the value for the specified field. If it is not possible to
* return the value, because the field is not supported or for some other reason, an exception is
@@ -377,9 +377,9 @@ final class MonthDay private (private val month: Int, private val day: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this month-day.
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -407,7 +407,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
* Gets the month-of-year field from 1 to 12.
*
* This method returns the month as an {@code int} from 1 to 12. Application code is frequently
- * clearer if the enum {@link Month} is used by calling {@link #getMonth()}.
+ * clearer if the enum {@link Month} is used by calling {@link #getMonth()} .
*
* @return
* the month-of-year, from 1 to 12
@@ -421,7 +421,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
*
* This method returns the enum {@link Month} for the month. This avoids confusion as to what
* {@code int} values mean. If you need access to the primitive {@code int} value then the enum
- * provides the {@link Month#getValue() int value}.
+ * provides the {@link Month#getValue() int value} .
*
* @return
* the month-of-year, not null
@@ -466,7 +466,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
* @param month
* the month-of-year to set in the returned month-day, from 1 (January) to 12 (December)
* @return
- * a { @code MonthDay} based on this month-day with the requested month, not null
+ * a {@code MonthDay} based on this month-day with the requested month, not null
* @throws DateTimeException
* if the month-of-year value is invalid
*/
@@ -483,7 +483,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
* @param month
* the month-of-year to set in the returned month-day, not null
* @return
- * a { @code MonthDay} based on this month-day with the requested month, not null
+ * a {@code MonthDay} based on this month-day with the requested month, not null
*/
def `with`(month: Month): MonthDay = {
Objects.requireNonNull(month, "month")
@@ -504,7 +504,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
* @param dayOfMonth
* the day-of-month to set in the return month-day, from 1 to 31
* @return
- * a { @code MonthDay} based on this month-day with the requested day, not null
+ * a {@code MonthDay} based on this month-day with the requested day, not null
* @throws DateTimeException
* if the day-of-month value is invalid
* @throws DateTimeException
@@ -580,7 +580,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
}
/**
- * Combines this month-day with a year to create a {@code LocalDate}.
+ * Combines this month-day with a year to create a {@code LocalDate} .
*
* This returns a {@code LocalDate} formed from this month-day and the specified year.
*
@@ -602,7 +602,7 @@ final class MonthDay private (private val month: Int, private val day: Int)
* Compares this month-day to another month-day.
*
* The comparison is based first on value of the month, then on the value of the day. It is
- * "consistent with equals", as defined by {@link Comparable}.
+ * "consistent with equals", as defined by {@link Comparable} .
*
* @param other
* the other month-day to compare to, not null
@@ -663,9 +663,9 @@ final class MonthDay private (private val month: Int, private val day: Int)
override def hashCode: Int = (month << 6) + day
/**
- * Outputs this month-day as a {@code String}, such as {@code --12-03}.
+ * Outputs this month-day as a {@code String} , such as {@code --12-03} .
*
- * The output will be in the format {@code --MM-dd}:
+ * The output will be in the format {@code --MM-dd} :
*
* @return
* a string representation of this month-day, not null
diff --git a/core/shared/src/main/scala/org/threeten/bp/OffsetDateTime.scala b/core/shared/src/main/scala/org/threeten/bp/OffsetDateTime.scala
index 3c8e19955..8a575838c 100644
--- a/core/shared/src/main/scala/org/threeten/bp/OffsetDateTime.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/OffsetDateTime.scala
@@ -57,7 +57,7 @@ import org.threeten.bp.zone.ZoneRules
object OffsetDateTime {
/**
- * The minimum supported {@code OffsetDateTime}, '-999999999-01-01T00:00:00+18:00'. This is the
+ * The minimum supported {@code OffsetDateTime} , '-999999999-01-01T00:00:00+18:00'. This is the
* local date-time of midnight at the start of the minimum date in the maximum offset (larger
* offsets are earlier on the time-line). This combines {@link LocalDateTime#MIN} and {@link
* ZoneOffset#MAX}. This could be used by an application as a "far past" date-time.
@@ -65,10 +65,10 @@ object OffsetDateTime {
lazy val MIN: OffsetDateTime = LocalDateTime.MIN.atOffset(ZoneOffset.MAX)
/**
- * The maximum supported {@code OffsetDateTime}, '+999999999-12-31T23:59:59.999999999-18:00'. This
- * is the local date-time just before midnight at the end of the maximum date in the minimum
+ * The maximum supported {@code OffsetDateTime} , '+999999999-12-31T23:59:59.999999999-18:00'.
+ * This is the local date-time just before midnight at the end of the maximum date in the minimum
* offset (larger negative offsets are later on the time-line). This combines {@link
- * LocalDateTime#MAX} and {@link ZoneOffset#MIN}. This could be used by an application as a "far
+ * LocalDateTime#MAX} and {@link ZoneOffset#MIN} . This could be used by an application as a "far
* future" date-time.
*/
lazy val MAX: OffsetDateTime = LocalDateTime.MAX.atOffset(ZoneOffset.MIN)
@@ -139,7 +139,7 @@ object OffsetDateTime {
* calculated from the time-zone in the clock.
*
* Using this method allows the use of an alternate clock for testing. The alternate clock may be
- * introduced using {@link Clock dependency injection}.
+ * introduced using {@link Clock dependency injection} .
*
* @param clock
* the clock to use, not null
@@ -263,20 +263,20 @@ object OffsetDateTime {
* Obtains an instance of {@code OffsetDateTime} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code OffsetDateTime}.
+ * converts the arbitrary temporal object to an instance of {@code OffsetDateTime} .
*
- * The conversion extracts and combines {@code LocalDateTime} and {@code ZoneOffset}. If that
- * fails it will try to extract and combine {@code Instant} and {@code ZoneOffset}.
+ * The conversion extracts and combines {@code LocalDateTime} and {@code ZoneOffset} . If that
+ * fails it will try to extract and combine {@code Instant} and {@code ZoneOffset} .
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code OffsetDateTime::from}.
+ * to be used in queries via method reference, {@code OffsetDateTime::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the offset date-time, not null
* @throws DateTimeException
- * if unable to convert to an { @code OffsetDateTime}
+ * if unable to convert to an {@code OffsetDateTime}
*/
def from(temporal: TemporalAccessor): OffsetDateTime =
temporal match {
@@ -350,9 +350,9 @@ object OffsetDateTime {
* {@code OffsetDateTime} is an immutable representation of a date-time with an offset. This class
* stores all date and time fields, to a precision of nanoseconds, as well as the offset from
* UTC/Greenwich. For example, the value "2nd October 2007 at 13:45.30.123456789 +02:00" can be
- * stored in an {@code OffsetDateTime}.
+ * stored in an {@code OffsetDateTime} .
*
- * {@code OffsetDateTime}, {@link ZonedDateTime} and {@link Instant} all store an instant on the
+ * {@code OffsetDateTime} , {@link ZonedDateTime} and {@link Instant} all store an instant on the
* time-line to nanosecond precision. {@code Instant} is the simplest, simply representing the
* instant. {@code OffsetDateTime} adds to the instant the offset from UTC/Greenwich, which allows
* the local date-time to be obtained. {@code ZonedDateTime} adds full time-zone rules.
@@ -410,7 +410,7 @@ final class OffsetDateTime private (
* import static
@@ -716,7 +716,7 @@ final class OffsetDateTime private (
*
* result = offsetDateTime.with(JULY).with(lastDayOfMonth());
*
- * The classes {@link LocalDate}, {@link LocalTime} and {@link ZoneOffset} implement {@code
+ * The classes {@link LocalDate} , {@link LocalTime} and {@link ZoneOffset} implement {@code
* TemporalAdjuster}, thus this method can be used to change the date, time or offset:
* result = offsetDateTime.with(date); result = offsetDateTime.with(time); result =
* offsetDateTime.with(offset);
@@ -730,7 +730,7 @@ final class OffsetDateTime private (
* @param adjuster
* the adjuster to use, not null
* @return
- * an { @code OffsetDateTime} based on { @code this} with the adjustment made, not null
+ * an {@code OffsetDateTime} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -750,7 +750,7 @@ final class OffsetDateTime private (
/**
* Returns a copy of this date-time with the specified field set to a new value.
*
- * This returns a new {@code OffsetDateTime}, based on this one, with the value for the specified
+ * This returns a new {@code OffsetDateTime} , based on this one, with the value for the specified
* field changed. This can be used to change any supported field, such as the year, month or
* day-of-month. If it is not possible to set the value, because the field is not supported or for
* some other reason, an exception is thrown.
@@ -771,12 +771,12 @@ final class OffsetDateTime private (
* DateTimeException} will be thrown.
*
* The other {@link #isSupported(TemporalField) supported fields} will behave as per the matching
- * method on {@link LocalDateTime#with(TemporalField, long) LocalDateTime}. In this case, the
+ * method on {@link LocalDateTime#with(TemporalField, long) LocalDateTime} . In this case, the
* offset is not part of the calculation and will be unchanged.
*
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.adjustInto(Temporal, long)} passing {@code this} as the argument.
* In this case, the field determines whether and how to adjust the instant.
*
@@ -787,7 +787,7 @@ final class OffsetDateTime private (
* @param newValue
* the new value of the field in the result
* @return
- * an { @code OffsetDateTime} based on { @code this} with the specified field set, not null
+ * an {@code OffsetDateTime} based on {@code this} with the specified field set, not null
* @throws DateTimeException
* if the field cannot be set
* @throws ArithmeticException
@@ -817,7 +817,7 @@ final class OffsetDateTime private (
* @param year
* the year to set in the result, from MIN_YEAR to MAX_YEAR
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested year, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested year, not null
* @throws DateTimeException
* if the year value is invalid
*/
@@ -833,7 +833,7 @@ final class OffsetDateTime private (
* @param month
* the month-of-year to set in the result, from 1 (January) to 12 (December)
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested month, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested month, not null
* @throws DateTimeException
* if the month-of-year value is invalid
*/
@@ -849,7 +849,7 @@ final class OffsetDateTime private (
* @param dayOfMonth
* the day-of-month to set in the result, from 1 to 28-31
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested day, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested day, not null
* @throws DateTimeException
* if the day-of-month value is invalid
* @throws DateTimeException
@@ -867,7 +867,7 @@ final class OffsetDateTime private (
* @param dayOfYear
* the day-of-year to set in the result, from 1 to 365-366
* @return
- * an { @code OffsetDateTime} based on this date with the requested day, not null
+ * an {@code OffsetDateTime} based on this date with the requested day, not null
* @throws DateTimeException
* if the day-of-year value is invalid
* @throws DateTimeException
@@ -886,7 +886,7 @@ final class OffsetDateTime private (
* @param hour
* the hour-of-day to set in the result, from 0 to 23
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested hour, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested hour, not null
* @throws DateTimeException
* if the hour value is invalid
*/
@@ -902,7 +902,7 @@ final class OffsetDateTime private (
* @param minute
* the minute-of-hour to set in the result, from 0 to 59
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested minute, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested minute, not null
* @throws DateTimeException
* if the minute value is invalid
*/
@@ -918,7 +918,7 @@ final class OffsetDateTime private (
* @param second
* the second-of-minute to set in the result, from 0 to 59
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested second, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested second, not null
* @throws DateTimeException
* if the second value is invalid
*/
@@ -934,7 +934,7 @@ final class OffsetDateTime private (
* @param nanoOfSecond
* the nano-of-second to set in the result, from 0 to 999,999,999
* @return
- * an { @code OffsetDateTime} based on this date-time with the requested nanosecond, not null
+ * an {@code OffsetDateTime} based on this date-time with the requested nanosecond, not null
* @throws DateTimeException
* if the nanos value is invalid
*/
@@ -949,7 +949,7 @@ final class OffsetDateTime private (
*
* The unit must have a {@linkplain TemporalUnit#getDuration() duration} that divides into the
* length of a standard day without remainder. This includes all supplied time units on {@link
- * ChronoUnit} and {@link ChronoUnit#DAYS DAYS}. Other units throw an exception.
+ * ChronoUnit} and {@link ChronoUnit#DAYS DAYS} . Other units throw an exception.
*
* The offset does not affect the calculation and will be the same in the result.
*
@@ -958,7 +958,7 @@ final class OffsetDateTime private (
* @param unit
* the unit to truncate to, not null
* @return
- * an { @code OffsetDateTime} based on this date-time with the time truncated, not null
+ * an {@code OffsetDateTime} based on this date-time with the time truncated, not null
* @throws DateTimeException
* if unable to truncate
*/
@@ -970,7 +970,7 @@ final class OffsetDateTime private (
* This method returns a new date-time based on this time with the specified period added. The
* amount is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #plus(long, TemporalUnit)}. The offset is not part of the
+ * typically calls back to {@link #plus(long, TemporalUnit)} . The offset is not part of the
* calculation and will be unchanged in the result.
*
* This instance is immutable and unaffected by this method call.
@@ -978,7 +978,7 @@ final class OffsetDateTime private (
* @param amount
* the amount to add, not null
* @return
- * an { @code OffsetDateTime} based on this date-time with the addition made, not null
+ * an {@code OffsetDateTime} based on this date-time with the addition made, not null
* @throws DateTimeException
* if the addition cannot be made
* @throws ArithmeticException
@@ -1003,7 +1003,7 @@ final class OffsetDateTime private (
* @param unit
* the unit of the period to add, not null
* @return
- * an { @code OffsetDateTime} based on this date-time with the specified period added, not null
+ * an {@code OffsetDateTime} based on this date-time with the specified period added, not null
* @throws DateTimeException
* if the unit cannot be added to this type
*/
@@ -1027,7 +1027,7 @@ final class OffsetDateTime private (
* @param years
* the years to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the years added, not null
+ * an {@code OffsetDateTime} based on this date-time with the years added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1048,7 +1048,7 @@ final class OffsetDateTime private (
* @param months
* the months to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the months added, not null
+ * an {@code OffsetDateTime} based on this date-time with the months added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1068,7 +1068,7 @@ final class OffsetDateTime private (
* @param weeks
* the weeks to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the weeks added, not null
+ * an {@code OffsetDateTime} based on this date-time with the weeks added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1088,7 +1088,7 @@ final class OffsetDateTime private (
* @param days
* the days to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the days added, not null
+ * an {@code OffsetDateTime} based on this date-time with the days added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1102,7 +1102,7 @@ final class OffsetDateTime private (
* @param hours
* the hours to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the hours added, not null
+ * an {@code OffsetDateTime} based on this date-time with the hours added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1116,7 +1116,7 @@ final class OffsetDateTime private (
* @param minutes
* the minutes to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the minutes added, not null
+ * an {@code OffsetDateTime} based on this date-time with the minutes added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1130,7 +1130,7 @@ final class OffsetDateTime private (
* @param seconds
* the seconds to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the seconds added, not null
+ * an {@code OffsetDateTime} based on this date-time with the seconds added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1144,7 +1144,7 @@ final class OffsetDateTime private (
* @param nanos
* the nanos to add, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the nanoseconds added, not null
+ * an {@code OffsetDateTime} based on this date-time with the nanoseconds added, not null
* @throws DateTimeException
* if the unit cannot be added to this type
*/
@@ -1156,7 +1156,7 @@ final class OffsetDateTime private (
* This method returns a new date-time based on this time with the specified period subtracted.
* The amount is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #minus(long, TemporalUnit)}. The offset is not part of the
+ * typically calls back to {@link #minus(long, TemporalUnit)} . The offset is not part of the
* calculation and will be unchanged in the result.
*
* This instance is immutable and unaffected by this method call.
@@ -1164,7 +1164,7 @@ final class OffsetDateTime private (
* @param amount
* the amount to subtract, not null
* @return
- * an { @code OffsetDateTime} based on this date-time with the subtraction made, not null
+ * an {@code OffsetDateTime} based on this date-time with the subtraction made, not null
* @throws DateTimeException
* if the subtraction cannot be made
* @throws ArithmeticException
@@ -1189,7 +1189,7 @@ final class OffsetDateTime private (
* @param unit
* the unit of the period to subtract, not null
* @return
- * an { @code OffsetDateTime} based on this date-time with the specified period subtracted, not
+ * an {@code OffsetDateTime} based on this date-time with the specified period subtracted, not
* null
*/
override def minus(amountToSubtract: Long, unit: TemporalUnit): OffsetDateTime =
@@ -1212,7 +1212,7 @@ final class OffsetDateTime private (
* @param years
* the years to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the years subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the years subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1235,7 +1235,7 @@ final class OffsetDateTime private (
* @param months
* the months to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the months subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the months subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1257,7 +1257,7 @@ final class OffsetDateTime private (
* @param weeks
* the weeks to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the weeks subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the weeks subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1279,7 +1279,7 @@ final class OffsetDateTime private (
* @param days
* the days to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the days subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the days subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1295,7 +1295,7 @@ final class OffsetDateTime private (
* @param hours
* the hours to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the hours subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the hours subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1311,7 +1311,7 @@ final class OffsetDateTime private (
* @param minutes
* the minutes to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the minutes subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the minutes subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1327,7 +1327,7 @@ final class OffsetDateTime private (
* @param seconds
* the seconds to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the seconds subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the seconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1344,7 +1344,7 @@ final class OffsetDateTime private (
* @param nanos
* the nanos to subtract, may be negative
* @return
- * an { @code OffsetDateTime} based on this date-time with the nanoseconds subtracted, not null
+ * an {@code OffsetDateTime} based on this date-time with the nanoseconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1392,7 +1392,7 @@ final class OffsetDateTime private (
* and time changed to be the same as this.
*
* The adjustment is equivalent to using {@link Temporal#with(TemporalField, long)} three times,
- * passing {@link ChronoField#EPOCH_DAY}, {@link ChronoField#NANO_OF_DAY} and {@link
+ * passing {@link ChronoField#EPOCH_DAY} , {@link ChronoField#NANO_OF_DAY} and {@link
* ChronoField#OFFSET_SECONDS} as the fields.
*
* In most cases, it is clearer to reverse the calling pattern by using {@link
@@ -1424,9 +1424,9 @@ final class OffsetDateTime private (
* This calculates the period between two date-times in terms of a single unit. The start and end
* points are {@code this} and the specified date-time. The result will be negative if the end is
* before the start. For example, the period in days between two date-times can be calculated
- * using {@code startDateTime.until(endDateTime, DAYS)}.
+ * using {@code startDateTime.until(endDateTime, DAYS)} .
*
- * The {@code Temporal} passed to this method must be an {@code OffsetDateTime}. If the offset
+ * The {@code Temporal} passed to this method must be an {@code OffsetDateTime} . If the offset
* differs between the two date-times, the specified end date-time is normalized to have the same
* offset as this date-time.
*
@@ -1434,26 +1434,26 @@ final class OffsetDateTime private (
* two date-times. For example, the period in months between 2012-06-15T00:00Z and
* 2012-08-14T23:59Z will only be one month as it is one minute short of two months.
*
- * This method operates in association with {@link TemporalUnit#between}. The result of this
+ * This method operates in association with {@link TemporalUnit#between} . The result of this
* method is a {@code long} representing the amount of the specified unit. By contrast, the result
* of {@code between} is an object that can be used directly in addition/subtraction: long
* period = start.until(end, MONTHS); // this method dateTime.plus(MONTHS.between(start, end)); //
* use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code NANOS},
- * {@code MICROS}, {@code MILLIS}, {@code SECONDS}, {@code MINUTES}, {@code HOURS} and {@code
- * HALF_DAYS}, {@code DAYS}, {@code WEEKS}, {@code MONTHS}, {@code YEARS}, {@code DECADES}, {@code
- * CENTURIES}, {@code MILLENNIA} and {@code ERAS} are supported. Other {@code ChronoUnit} values
- * will throw an exception.
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code NANOS}
+ * , {@code MICROS} , {@code MILLIS} , {@code SECONDS} , {@code MINUTES} , {@code HOURS} and
+ * {@code HALF_DAYS}, {@code DAYS} , {@code WEEKS} , {@code MONTHS} , {@code YEARS} ,
+ * {@code DECADES} , {@code CENTURIES}, {@code MILLENNIA} and {@code ERAS} are supported. Other
+ * {@code ChronoUnit} values will throw an exception.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end date-time, which is converted to an { @code OffsetDateTime}, not null
+ * the end date-time, which is converted to an {@code OffsetDateTime} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -1481,8 +1481,8 @@ final class OffsetDateTime private (
* This avoids any problems with local time-line gaps or overlaps. The result might have different
* values for fields such as hour, minute an even day.
*
- * To attempt to retain the values of the fields, use {@link #atZoneSimilarLocal(ZoneId)}. To use
- * the offset as the zone ID, use {@link #toZonedDateTime()}.
+ * To attempt to retain the values of the fields, use {@link #atZoneSimilarLocal(ZoneId)} . To use
+ * the offset as the zone ID, use {@link #toZonedDateTime()} .
*
* @param zone
* the time-zone to use, not null
@@ -1510,7 +1510,7 @@ final class OffsetDateTime private (
* after this method.
*
* To create a zoned date-time at the same instant irrespective of the local time-line, use {@link
- * #atZoneSameInstant(ZoneId)}. To use the offset as the zone ID, use {@link #toZonedDateTime()}.
+ * #atZoneSameInstant(ZoneId)}. To use the offset as the zone ID, use {@link #toZonedDateTime()} .
*
* @param zone
* the time-zone to use, not null
@@ -1552,7 +1552,7 @@ final class OffsetDateTime private (
def toLocalTime: LocalTime = dateTime.toLocalTime
/**
- * Converts this date-time to an {@code OffsetTime}.
+ * Converts this date-time to an {@code OffsetTime} .
*
* This returns an offset time with the same local time and offset.
*
@@ -1575,10 +1575,10 @@ final class OffsetDateTime private (
def toZonedDateTime: ZonedDateTime = ZonedDateTime.of(dateTime, offset)
/**
- * Converts this date-time to an {@code Instant}.
+ * Converts this date-time to an {@code Instant} .
*
* @return
- * an { @code Instant} representing the same instant, not null
+ * an {@code Instant} representing the same instant, not null
*/
def toInstant: Instant = dateTime.toInstant(offset)
@@ -1598,7 +1598,7 @@ final class OffsetDateTime private (
* Compares this {@code OffsetDateTime} to another date-time.
*
* The comparison is based on the instant then on the local date-time. It is "consistent with
- * equals", as defined by {@link Comparable}.
+ * equals", as defined by {@link Comparable} .
*
* For example, the following is the comparator order:
Values #2 and #3
* represent the same instant on the time-line. When two values represent the same instant, the
* local date-time is compared to distinguish them. This step is needed to make the ordering
- * consistent with {@code equals()}.
+ * consistent with {@code equals()} .
*
* @param other
* the other date-time to compare to, not null
@@ -1682,7 +1682,7 @@ final class OffsetDateTime private (
* Checks if this date-time is equal to another date-time.
*
* The comparison is based on the local date-time and the offset. To compare for the same instant
- * on the time-line, use {@link #isEqual}. Only objects of type {@code OffsetDateTime} are
+ * on the time-line, use {@link #isEqual} . Only objects of type {@code OffsetDateTime} are
* compared, other types return false.
*
* @param obj
@@ -1706,7 +1706,7 @@ final class OffsetDateTime private (
override def hashCode: Int = dateTime.hashCode ^ offset.hashCode
/**
- * Outputs this date-time as a {@code String}, such as {@code 2007-12-03T10:15:30+01:00}.
+ * Outputs this date-time as a {@code String} , such as {@code 2007-12-03T10:15:30+01:00} .
*
* The output will be one of the following ISO-8601 formats:
All
* other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -349,9 +349,9 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -370,7 +370,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this time as an {@code int}.
+ * Gets the value of the specified field from this time as an {@code int} .
*
* This queries this time for the value for the specified field. The returned value will always be
* within the valid range of values for the field. If it is not possible to return the value,
@@ -379,10 +379,10 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this time,
* except {@code NANO_OF_DAY} and {@code MICRO_OF_DAY} which are too large to fit in an {@code
- * int} and throw a {@code DateTimeException}. All other {@code ChronoField} instances will throw
- * a {@code DateTimeException}.
+ * int} and throw a {@code DateTimeException} . All other {@code ChronoField} instances will throw
+ * a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -398,16 +398,16 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
override def get(field: TemporalField): Int = super.get(field)
/**
- * Gets the value of the specified field from this time as a {@code long}.
+ * Gets the value of the specified field from this time as a {@code long} .
*
* This queries this time for the value for the specified field. If it is not possible to return
* the value, because the field is not supported or for some other reason, an exception is thrown.
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this time. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -443,7 +443,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
*
* This method returns an object with the same {@code LocalTime} and the specified {@code
* ZoneOffset}. No calculation is needed or performed. For example, if this time represents {@code
- * 10:30+02:00} and the offset specified is {@code +03:00}, then this method will return {@code
+ * 10:30+02:00} and the offset specified is {@code +03:00} , then this method will return {@code
* 10:30+03:00}.
*
* To take into account the difference between the offsets, and adjust the time fields, use {@link
@@ -454,7 +454,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param offset
* the zone offset to change to, not null
* @return
- * an { @code OffsetTime} based on this time with the requested offset, not null
+ * an {@code OffsetTime} based on this time with the requested offset, not null
*/
def withOffsetSameLocal(offset: ZoneOffset): OffsetTime =
if (offset != null && (offset == this.offset)) this
@@ -468,16 +468,16 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* adjusted by the difference between the two offsets. This will result in the old and new objects
* representing the same instant an an implied day. This is useful for finding the local time in a
* different offset. For example, if this time represents {@code 10:30+02:00} and the offset
- * specified is {@code +03:00}, then this method will return {@code 11:30+03:00}.
+ * specified is {@code +03:00} , then this method will return {@code 11:30+03:00} .
*
- * To change the offset without adjusting the local time use {@link #withOffsetSameLocal}.
+ * To change the offset without adjusting the local time use {@link #withOffsetSameLocal} .
*
* This instance is immutable and unaffected by this method call.
*
* @param offset
* the zone offset to change to, not null
* @return
- * an { @code OffsetTime} based on this time with the requested offset, not null
+ * an {@code OffsetTime} based on this time with the requested offset, not null
*/
def withOffsetSameInstant(offset: ZoneOffset): OffsetTime =
if (offset == this.offset)
@@ -523,14 +523,14 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
/**
* Returns an adjusted copy of this time.
*
- * This returns a new {@code OffsetTime}, based on this one, with the time adjusted. The
+ * This returns a new {@code OffsetTime} , based on this one, with the time adjusted. The
* adjustment takes place using the specified adjuster strategy object. Read the documentation of
* the adjuster to understand what adjustment will be made.
*
* A simple adjuster might simply set the one of the fields, such as the hour field. A more
* complex adjuster might set the time to the last hour of the day.
*
- * The classes {@link LocalTime} and {@link ZoneOffset} implement {@code TemporalAdjuster}, thus
+ * The classes {@link LocalTime} and {@link ZoneOffset} implement {@code TemporalAdjuster} , thus
* this method can be used to change the time or offset: Specification for implementors
This class is immutable and thread-safe.
*
@@ -323,7 +323,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* result = offsetTime.with(time);
* result = offsetTime.with(offset);
*
@@ -543,7 +543,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param adjuster
* the adjuster to use, not null
* @return
- * an { @code OffsetTime} based on { @code this} with the adjustment made, not null
+ * an {@code OffsetTime} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -560,7 +560,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
/**
* Returns a copy of this time with the specified field set to a new value.
*
- * This returns a new {@code OffsetTime}, based on this one, with the value for the specified
+ * This returns a new {@code OffsetTime} , based on this one, with the value for the specified
* field changed. This can be used to change any supported field, such as the hour, minute or
* second. If it is not possible to set the value, because the field is not supported or for some
* other reason, an exception is thrown.
@@ -575,9 +575,9 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* method on {@link LocalTime#with(TemporalField, long)} LocalTime}. In this case, the offset is
* not part of the calculation and will be unchanged.
*
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.adjustInto(Temporal, long)} passing {@code this} as the argument.
* In this case, the field determines whether and how to adjust the instant.
*
@@ -588,7 +588,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param newValue
* the new value of the field in the result
* @return
- * an { @code OffsetTime} based on { @code this} with the specified field set, not null
+ * an {@code OffsetTime} based on {@code this} with the specified field set, not null
* @throws DateTimeException
* if the field cannot be set
* @throws ArithmeticException
@@ -613,7 +613,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param hour
* the hour-of-day to set in the result, from 0 to 23
* @return
- * an { @code OffsetTime} based on this time with the requested hour, not null
+ * an {@code OffsetTime} based on this time with the requested hour, not null
* @throws DateTimeException
* if the hour value is invalid
*/
@@ -629,7 +629,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param minute
* the minute-of-hour to set in the result, from 0 to 59
* @return
- * an { @code OffsetTime} based on this time with the requested minute, not null
+ * an {@code OffsetTime} based on this time with the requested minute, not null
* @throws DateTimeException
* if the minute value is invalid
*/
@@ -645,7 +645,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param second
* the second-of-minute to set in the result, from 0 to 59
* @return
- * an { @code OffsetTime} based on this time with the requested second, not null
+ * an {@code OffsetTime} based on this time with the requested second, not null
* @throws DateTimeException
* if the second value is invalid
*/
@@ -661,7 +661,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param nanoOfSecond
* the nano-of-second to set in the result, from 0 to 999,999,999
* @return
- * an { @code OffsetTime} based on this time with the requested nanosecond, not null
+ * an {@code OffsetTime} based on this time with the requested nanosecond, not null
* @throws DateTimeException
* if the nanos value is invalid
*/
@@ -676,7 +676,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
*
* The unit must have a {@linkplain TemporalUnit#getDuration() duration} that divides into the
* length of a standard day without remainder. This includes all supplied time units on {@link
- * ChronoUnit} and {@link ChronoUnit#DAYS DAYS}. Other units throw an exception.
+ * ChronoUnit} and {@link ChronoUnit#DAYS DAYS} . Other units throw an exception.
*
* The offset does not affect the calculation and will be the same in the result.
*
@@ -685,7 +685,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param unit
* the unit to truncate to, not null
* @return
- * an { @code OffsetTime} based on this time with the time truncated, not null
+ * an {@code OffsetTime} based on this time with the time truncated, not null
* @throws DateTimeException
* if unable to truncate
*/
@@ -697,7 +697,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* This method returns a new time based on this time with the specified period added. The amount
* is typically {@link Period} but may be any other type implementing the {@link TemporalAmount}
* interface. The calculation is delegated to the specified adjuster, which typically calls back
- * to {@link #plus(long, TemporalUnit)}. The offset is not part of the calculation and will be
+ * to {@link #plus(long, TemporalUnit)} . The offset is not part of the calculation and will be
* unchanged in the result.
*
* This instance is immutable and unaffected by this method call.
@@ -705,7 +705,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param amount
* the amount to add, not null
* @return
- * an { @code OffsetTime} based on this time with the addition made, not null
+ * an {@code OffsetTime} based on this time with the addition made, not null
* @throws DateTimeException
* if the addition cannot be made
* @throws ArithmeticException
@@ -730,7 +730,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param unit
* the unit of the period to add, not null
* @return
- * an { @code OffsetTime} based on this time with the specified period added, not null
+ * an {@code OffsetTime} based on this time with the specified period added, not null
* @throws DateTimeException
* if the unit cannot be added to this type
*/
@@ -749,7 +749,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param hours
* the hours to add, may be negative
* @return
- * an { @code OffsetTime} based on this time with the hours added, not null
+ * an {@code OffsetTime} based on this time with the hours added, not null
*/
def plusHours(hours: Long): OffsetTime = `with`(time.plusHours(hours), offset)
@@ -764,7 +764,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param minutes
* the minutes to add, may be negative
* @return
- * an { @code OffsetTime} based on this time with the minutes added, not null
+ * an {@code OffsetTime} based on this time with the minutes added, not null
*/
def plusMinutes(minutes: Long): OffsetTime = `with`(time.plusMinutes(minutes), offset)
@@ -779,7 +779,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param seconds
* the seconds to add, may be negative
* @return
- * an { @code OffsetTime} based on this time with the seconds added, not null
+ * an {@code OffsetTime} based on this time with the seconds added, not null
*/
def plusSeconds(seconds: Long): OffsetTime = `with`(time.plusSeconds(seconds), offset)
@@ -794,7 +794,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param nanos
* the nanos to add, may be negative
* @return
- * an { @code OffsetTime} based on this time with the nanoseconds added, not null
+ * an {@code OffsetTime} based on this time with the nanoseconds added, not null
*/
def plusNanos(nanos: Long): OffsetTime = `with`(time.plusNanos(nanos), offset)
@@ -804,7 +804,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* This method returns a new time based on this time with the specified period subtracted. The
* amount is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #minus(long, TemporalUnit)}. The offset is not part of the
+ * typically calls back to {@link #minus(long, TemporalUnit)} . The offset is not part of the
* calculation and will be unchanged in the result.
*
* This instance is immutable and unaffected by this method call.
@@ -812,7 +812,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param amount
* the amount to subtract, not null
* @return
- * an { @code OffsetTime} based on this time with the subtraction made, not null
+ * an {@code OffsetTime} based on this time with the subtraction made, not null
* @throws DateTimeException
* if the subtraction cannot be made
* @throws ArithmeticException
@@ -837,7 +837,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param unit
* the unit of the period to subtract, not null
* @return
- * an { @code OffsetTime} based on this time with the specified period subtracted, not null
+ * an {@code OffsetTime} based on this time with the specified period subtracted, not null
* @throws DateTimeException
* if the unit cannot be added to this type
*/
@@ -856,7 +856,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param hours
* the hours to subtract, may be negative
* @return
- * an { @code OffsetTime} based on this time with the hours subtracted, not null
+ * an {@code OffsetTime} based on this time with the hours subtracted, not null
*/
def minusHours(hours: Long): OffsetTime = `with`(time.minusHours(hours), offset)
@@ -871,7 +871,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param minutes
* the minutes to subtract, may be negative
* @return
- * an { @code OffsetTime} based on this time with the minutes subtracted, not null
+ * an {@code OffsetTime} based on this time with the minutes subtracted, not null
*/
def minusMinutes(minutes: Long): OffsetTime = `with`(time.minusMinutes(minutes), offset)
@@ -886,7 +886,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param seconds
* the seconds to subtract, may be negative
* @return
- * an { @code OffsetTime} based on this time with the seconds subtracted, not null
+ * an {@code OffsetTime} based on this time with the seconds subtracted, not null
*/
def minusSeconds(seconds: Long): OffsetTime = `with`(time.minusSeconds(seconds), offset)
@@ -901,7 +901,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* @param nanos
* the nanos to subtract, may be negative
* @return
- * an { @code OffsetTime} based on this time with the nanoseconds subtracted, not null
+ * an {@code OffsetTime} based on this time with the nanoseconds subtracted, not null
*/
def minusNanos(nanos: Long): OffsetTime = `with`(time.minusNanos(nanos), offset)
@@ -973,34 +973,34 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* This calculates the period between two times in terms of a single unit. The start and end
* points are {@code this} and the specified time. The result will be negative if the end is
* before the start. For example, the period in hours between two times can be calculated using
- * {@code startTime.until(endTime, HOURS)}.
+ * {@code startTime.until(endTime, HOURS)} .
*
- * The {@code Temporal} passed to this method must be an {@code OffsetTime}. If the offset differs
- * between the two times, then the specified end time is normalized to have the same offset as
- * this time.
+ * The {@code Temporal} passed to this method must be an {@code OffsetTime} . If the offset
+ * differs between the two times, then the specified end time is normalized to have the same
+ * offset as this time.
*
* The calculation returns a whole number, representing the number of complete units between the
* two times. For example, the period in hours between 11:30Z and 13:29Z will only be one hour as
* it is one minute short of two hours.
*
- * This method operates in association with {@link TemporalUnit#between}. The result of this
+ * This method operates in association with {@link TemporalUnit#between} . The result of this
* method is a {@code long} representing the amount of the specified unit. By contrast, the result
* of {@code between} is an object that can be used directly in addition/subtraction: long
* period = start.until(end, HOURS); // this method dateTime.plus(HOURS.between(start, end)); //
* use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code NANOS},
- * {@code MICROS}, {@code MILLIS}, {@code SECONDS}, {@code MINUTES}, {@code HOURS} and {@code
- * HALF_DAYS} are supported. Other {@code ChronoUnit} values will throw an exception.
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code NANOS}
+ * , {@code MICROS} , {@code MILLIS} , {@code SECONDS} , {@code MINUTES} , {@code HOURS} and
+ * {@code HALF_DAYS} are supported. Other {@code ChronoUnit} values will throw an exception.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end time, which is converted to an { @code OffsetTime}, not null
+ * the end time, which is converted to an {@code OffsetTime} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -1032,7 +1032,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
}
/**
- * Combines this time with a date to create an {@code OffsetDateTime}.
+ * Combines this time with a date to create an {@code OffsetDateTime} .
*
* This returns an {@code OffsetDateTime} formed from this time and the specified date. All
* possible combinations of date and time are valid.
@@ -1071,7 +1071,7 @@ final class OffsetTime(private val time: LocalTime, private val offset: ZoneOffs
* Compares this {@code OffsetTime} to another time.
*
* The comparison is based first on the UTC equivalent instant, then on the local time. It is
- * "consistent with equals", as defined by {@link Comparable}.
+ * "consistent with equals", as defined by {@link Comparable} .
*
* For example, the following is the comparator order:
Specification for implementors
This class is immutable and thread-safe.
@@ -418,7 +418,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param years
* the years to represent, may be negative
* @return
- * a { @code Period} based on this period with the requested years, not null
+ * a {@code Period} based on this period with the requested years, not null
*/
def withYears(years: Int): Period =
if (years == this.years) this
@@ -438,7 +438,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param months
* the months to represent, may be negative
* @return
- * a { @code Period} based on this period with the requested months, not null
+ * a {@code Period} based on this period with the requested months, not null
*/
def withMonths(months: Int): Period =
if (months == this.months) this
@@ -455,7 +455,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param days
* the days to represent, may be negative
* @return
- * a { @code Period} based on this period with the requested days, not null
+ * a {@code Period} based on this period with the requested days, not null
*/
def withDays(days: Int): Period =
if (days == this.days) this
@@ -464,7 +464,7 @@ final class Period private (private val years: Int, private val months: Int, pri
/**
* Returns a copy of this period with the specified amount added.
*
- * This input amount is converted to a {@code Period} using {@code from(TemporalAmount)}. This
+ * This input amount is converted to a {@code Period} using {@code from(TemporalAmount)} . This
* operates separately on the years, months and days.
*
* For example, "1 year, 6 months and 3 days" plus "2 years, 2 months and 2 days" returns "3
@@ -475,7 +475,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param amountToAdd
* the period to add, not null
* @return
- * a { @code Period} based on this period with the requested period added, not null
+ * a {@code Period} based on this period with the requested period added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -499,7 +499,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param yearsToAdd
* the years to add, positive or negative
* @return
- * a { @code Period} based on this period with the specified years added, not null
+ * a {@code Period} based on this period with the specified years added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -519,7 +519,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param monthsToAdd
* the months to add, positive or negative
* @return
- * a { @code Period} based on this period with the specified months added, not null
+ * a {@code Period} based on this period with the specified months added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -539,7 +539,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param daysToAdd
* the days to add, positive or negative
* @return
- * a { @code Period} based on this period with the specified days added, not null
+ * a {@code Period} based on this period with the specified days added, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -550,7 +550,7 @@ final class Period private (private val years: Int, private val months: Int, pri
/**
* Returns a copy of this period with the specified amount subtracted.
*
- * This input amount is converted to a {@code Period} using {@code from(TemporalAmount)}. This
+ * This input amount is converted to a {@code Period} using {@code from(TemporalAmount)} . This
* operates separately on the years, months and days.
*
* For example, "1 year, 6 months and 3 days" minus "2 years, 2 months and 2 days" returns "-1
@@ -561,7 +561,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param amountToSubtract
* the period to subtract, not null
* @return
- * a { @code Period} based on this period with the requested period subtracted, not null
+ * a {@code Period} based on this period with the requested period subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -585,7 +585,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param yearsToSubtract
* the years to subtract, positive or negative
* @return
- * a { @code Period} based on this period with the specified years subtracted, not null
+ * a {@code Period} based on this period with the specified years subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -605,7 +605,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param monthsToSubtract
* the years to subtract, positive or negative
* @return
- * a { @code Period} based on this period with the specified months subtracted, not null
+ * a {@code Period} based on this period with the specified months subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -625,7 +625,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param daysToSubtract
* the months to subtract, positive or negative
* @return
- * a { @code Period} based on this period with the specified days subtracted, not null
+ * a {@code Period} based on this period with the specified days subtracted, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -642,7 +642,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* @param scalar
* the scalar to multiply by, not null
* @return
- * a { @code Period} based on this period with the amounts multiplied by the scalar, not null
+ * a {@code Period} based on this period with the amounts multiplied by the scalar, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -658,7 +658,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* Returns a new instance with each amount in this period negated.
*
* @return
- * a { @code Period} based on this period with the amounts negated, not null
+ * a {@code Period} based on this period with the amounts negated, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -680,7 +680,7 @@ final class Period private (private val years: Int, private val months: Int, pri
* This instance is immutable and unaffected by this method call.
*
* @return
- * a { @code Period} based on this period with excess months normalized to years, not null
+ * a {@code Period} based on this period with excess months normalized to years, not null
* @throws ArithmeticException
* if numeric overflow occurs
*/
@@ -817,7 +817,7 @@ final class Period private (private val years: Int, private val months: Int, pri
override def hashCode: Int = years + Integer.rotateLeft(months, 8) + Integer.rotateLeft(days, 16)
/**
- * Outputs this period as a {@code String}, such as {@code P6Y3M1D}.
+ * Outputs this period as a {@code String} , such as {@code P6Y3M1D} .
*
* The output will be in the ISO-8601 period format. A zero period will be represented as zero
* days, 'P0D'.
diff --git a/core/shared/src/main/scala/org/threeten/bp/Year.scala b/core/shared/src/main/scala/org/threeten/bp/Year.scala
index da7cb846c..0ff9b2280 100644
--- a/core/shared/src/main/scala/org/threeten/bp/Year.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/Year.scala
@@ -121,7 +121,7 @@ object Year {
}
/**
- * Obtains an instance of {@code Year}.
+ * Obtains an instance of {@code Year} .
*
* This method accepts a year value from the proleptic ISO calendar system.
*
@@ -129,7 +129,7 @@ object Year {
* 1BC/BCE is represented by 0.
The year 2BC/BCE is represented by -1.
*
* @param isoYear
- * the ISO proleptic year to represent, from { @code MIN_VALUE} to { @code MAX_VALUE}
+ * the ISO proleptic year to represent, from {@code MIN_VALUE} to {@code MAX_VALUE}
* @return
* the year, not null
* @throws DateTimeException
@@ -144,21 +144,21 @@ object Year {
* Obtains an instance of {@code Year} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code Year}.
+ * converts the arbitrary temporal object to an instance of {@code Year} .
*
* The conversion extracts the {@link ChronoField#YEAR year} field. The extraction is only
* permitted if the temporal object has an ISO chronology, or can be converted to a {@code
* LocalDate}.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code Year::from}.
+ * to be used in queries via method reference, {@code Year::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the year, not null
* @throws DateTimeException
- * if unable to convert to a { @code Year}
+ * if unable to convert to a {@code Year}
*/
def from(temporal: TemporalAccessor): Year = {
var _temporal = temporal
@@ -180,7 +180,7 @@ object Year {
}
/**
- * Obtains an instance of {@code Year} from a text string such as {@code 2007}.
+ * Obtains an instance of {@code Year} from a text string such as {@code 2007} .
*
* The string must represent a valid year. Years outside the range 0000 to 9999 must be prefixed
* by the plus or minus symbol.
@@ -240,7 +240,7 @@ object Year {
}
/**
- * A year in the ISO-8601 calendar system, such as {@code 2007}.
+ * A year in the ISO-8601 calendar system, such as {@code 2007} .
*
* {@code Year} is an immutable date-time object that represents a year. Any field that can be
* derived from a year can be obtained.
@@ -250,7 +250,7 @@ object Year {
* such, historical years must be treated with caution.
* All other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -327,9 +327,9 @@ final class Year private (private val year: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -348,7 +348,7 @@ final class Year private (private val year: Int)
super.range(field)
/**
- * Gets the value of the specified field from this year as an {@code int}.
+ * Gets the value of the specified field from this year as an {@code int} .
*
* This queries this year for the value for the specified field. The returned value will always be
* within the valid range of values for the field. If it is not possible to return the value,
@@ -356,9 +356,9 @@ final class Year private (private val year: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this year. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -375,16 +375,16 @@ final class Year private (private val year: Int)
range(field).checkValidIntValue(getLong(field), field)
/**
- * Gets the value of the specified field from this year as a {@code long}.
+ * Gets the value of the specified field from this year as a {@code long} .
*
* This queries this year for the value for the specified field. If it is not possible to return
* the value, because the field is not supported or for some other reason, an exception is thrown.
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this year. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -450,7 +450,7 @@ final class Year private (private val year: Int)
/**
* Returns an adjusted copy of this year.
*
- * This returns a new {@code Year}, based on this one, with the year adjusted. The adjustment
+ * This returns a new {@code Year} , based on this one, with the year adjusted. The adjustment
* takes place using the specified adjuster strategy object. Read the documentation of the
* adjuster to understand what adjustment will be made.
*
@@ -463,7 +463,7 @@ final class Year private (private val year: Int)
* @param adjuster
* the adjuster to use, not null
* @return
- * a { @code Year} based on { @code this} with the adjustment made, not null
+ * a {@code Year} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -475,23 +475,23 @@ final class Year private (private val year: Int)
/**
* Returns a copy of this year with the specified field set to a new value.
*
- * This returns a new {@code Year}, based on this one, with the value for the specified field
+ * This returns a new {@code Year} , based on this one, with the value for the specified field
* changed. If it is not possible to set the value, because the field is not supported or for some
* other reason, an exception is thrown.
*
* If the field is a {@link ChronoField} then the adjustment is implemented here. The supported
* fields behave as follows:
*
* In all cases, if the new value is outside the valid range of values for the field then a {@code
* DateTimeException} will be thrown.
*
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.adjustInto(Temporal, long)} passing {@code this} as the argument.
* In this case, the field determines whether and how to adjust the instant.
*
@@ -502,7 +502,7 @@ final class Year private (private val year: Int)
* @param newValue
* the new value of the field in the result
* @return
- * a { @code Year} based on { @code this} with the specified field set, not null
+ * a {@code Year} based on {@code this} with the specified field set, not null
* @throws DateTimeException
* if the field cannot be set
* @throws ArithmeticException
@@ -528,14 +528,14 @@ final class Year private (private val year: Int)
* This method returns a new year based on this year with the specified period added. The adder is
* typically {@link Period} but may be any other type implementing the {@link TemporalAmount}
* interface. The calculation is delegated to the specified adjuster, which typically calls back
- * to {@link #plus(long, TemporalUnit)}.
+ * to {@link #plus(long, TemporalUnit)} .
*
* This instance is immutable and unaffected by this method call.
*
* @param amount
* the amount to add, not null
* @return
- * a { @code Year} based on this year with the addition made, not null
+ * a {@code Year} based on this year with the addition made, not null
* @throws DateTimeException
* if the addition cannot be made
* @throws ArithmeticException
@@ -547,9 +547,9 @@ final class Year private (private val year: Int)
* {@inheritDoc}
*
* @throws DateTimeException
- * { @inheritDoc}
+ * {@inheritDoc}
* @throws ArithmeticException
- * { @inheritDoc}
+ * {@inheritDoc}
*/
def plus(amountToAdd: Long, unit: TemporalUnit): Year =
unit match {
@@ -574,7 +574,7 @@ final class Year private (private val year: Int)
* @param yearsToAdd
* the years to add, may be negative
* @return
- * a { @code Year} based on this year with the period added, not null
+ * a {@code Year} based on this year with the period added, not null
* @throws DateTimeException
* if the result exceeds the supported year range
*/
@@ -590,14 +590,14 @@ final class Year private (private val year: Int)
* This method returns a new year based on this year with the specified period subtracted. The
* subtractor is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #minus(long, TemporalUnit)}.
+ * typically calls back to {@link #minus(long, TemporalUnit)} .
*
* This instance is immutable and unaffected by this method call.
*
* @param amount
* the amount to subtract, not null
* @return
- * a { @code Year} based on this year with the subtraction made, not null
+ * a {@code Year} based on this year with the subtraction made, not null
* @throws DateTimeException
* if the subtraction cannot be made
* @throws ArithmeticException
@@ -609,9 +609,9 @@ final class Year private (private val year: Int)
* {@inheritDoc}
*
* @throws DateTimeException
- * { @inheritDoc}
+ * {@inheritDoc}
* @throws ArithmeticException
- * { @inheritDoc}
+ * {@inheritDoc}
*/
override def minus(amountToSubtract: Long, unit: TemporalUnit): Year =
if (amountToSubtract == Long.MinValue) plus(Long.MaxValue, unit).plus(1, unit)
@@ -625,7 +625,7 @@ final class Year private (private val year: Int)
* @param yearsToSubtract
* the years to subtract, may be negative
* @return
- * a { @code Year} based on this year with the period subtracted, not null
+ * a {@code Year} based on this year with the period subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported year range
*/
@@ -704,7 +704,7 @@ final class Year private (private val year: Int)
*
* This calculates the period between two years in terms of a single unit. The start and end
* points are {@code this} and the specified year. The result will be negative if the end is
- * before the start. The {@code Temporal} passed to this method must be a {@code Year}. For
+ * before the start. The {@code Temporal} passed to this method must be a {@code Year} . For
* example, the period in decades between two year can be calculated using {@code
* startYear.until(endYear, DECADES)}.
*
@@ -712,24 +712,24 @@ final class Year private (private val year: Int)
* two years. For example, the period in decades between 2012 and 2031 will only be one decade as
* it is one year short of two decades.
*
- * This method operates in association with {@link TemporalUnit#between}. The result of this
+ * This method operates in association with {@link TemporalUnit#between} . The result of this
* method is a {@code long} representing the amount of the specified unit. By contrast, the result
* of {@code between} is an object that can be used directly in addition/subtraction: long
* period = start.until(end, YEARS); // this method dateTime.plus(YEARS.between(start, end)); //
* use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code YEARS},
- * {@code DECADES}, {@code CENTURIES}, {@code MILLENNIA} and {@code ERAS} are supported. Other
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code YEARS}
+ * , {@code DECADES} , {@code CENTURIES} , {@code MILLENNIA} and {@code ERAS} are supported. Other
* {@code ChronoUnit} values will throw an exception.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end year, which is converted to a { @code Year}, not null
+ * the end year, which is converted to a {@code Year} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -758,7 +758,7 @@ final class Year private (private val year: Int)
}
/**
- * Combines this year with a day-of-year to create a {@code LocalDate}.
+ * Combines this year with a day-of-year to create a {@code LocalDate} .
*
* This returns a {@code LocalDate} formed from this year and the specified day-of-year.
*
@@ -775,7 +775,7 @@ final class Year private (private val year: Int)
def atDay(dayOfYear: Int): LocalDate = LocalDate.ofYearDay(year, dayOfYear)
/**
- * Combines this year with a month to create a {@code YearMonth}.
+ * Combines this year with a month to create a {@code YearMonth} .
*
* This returns a {@code YearMonth} formed from this year and the specified month. All possible
* combinations of year and month are valid.
@@ -791,7 +791,7 @@ final class Year private (private val year: Int)
def atMonth(month: Month): YearMonth = YearMonth.of(year, month)
/**
- * Combines this year with a month to create a {@code YearMonth}.
+ * Combines this year with a month to create a {@code YearMonth} .
*
* This returns a {@code YearMonth} formed from this year and the specified month. All possible
* combinations of year and month are valid.
@@ -809,7 +809,7 @@ final class Year private (private val year: Int)
def atMonth(month: Int): YearMonth = YearMonth.of(year, month)
/**
- * Combines this year with a month-day to create a {@code LocalDate}.
+ * Combines this year with a month-day to create a {@code LocalDate} .
*
* This returns a {@code LocalDate} formed from this year and the specified month-day.
*
@@ -827,7 +827,7 @@ final class Year private (private val year: Int)
* Compares this year to another year.
*
* The comparison is based on the value of the year. It is "consistent with equals", as defined by
- * {@link Comparable}.
+ * {@link Comparable} .
*
* @param other
* the other year to compare to, not null
@@ -883,7 +883,7 @@ final class Year private (private val year: Int)
override def hashCode: Int = year
/**
- * Outputs this year as a {@code String}.
+ * Outputs this year as a {@code String} .
*
* @return
* a string representation of this year, not null
diff --git a/core/shared/src/main/scala/org/threeten/bp/YearMonth.scala b/core/shared/src/main/scala/org/threeten/bp/YearMonth.scala
index b26ae855c..ce5ca0d6f 100644
--- a/core/shared/src/main/scala/org/threeten/bp/YearMonth.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/YearMonth.scala
@@ -63,14 +63,14 @@ import org.threeten.bp.temporal.UnsupportedTemporalTypeException
import org.threeten.bp.temporal.ValueRange
/**
- * A year-month in the ISO-8601 calendar system, such as {@code 2007-12}.
+ * A year-month in the ISO-8601 calendar system, such as {@code 2007-12} .
*
* {@code YearMonth} is an immutable date-time object that represents the combination of a year and
* month. Any field that can be derived from a year and month, such as quarter-of-year, can be
* obtained.
*
* This class does not store or represent a day, time or time-zone. For example, the value "October
- * 2007" can be stored in a {@code YearMonth}.
+ * 2007" can be stored in a {@code YearMonth} .
*
* The ISO-8601 calendar system is the modern civil calendar system used today in most of the world.
* It is equivalent to the proleptic Gregorian calendar system, in which today's rules for leap
@@ -176,21 +176,21 @@ object YearMonth {
* Obtains an instance of {@code YearMonth} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code YearMonth}.
+ * converts the arbitrary temporal object to an instance of {@code YearMonth} .
*
* The conversion extracts the {@link ChronoField#YEAR YEAR} and {@link ChronoField#MONTH_OF_YEAR
* MONTH_OF_YEAR} fields. The extraction is only permitted if the temporal object has an ISO
- * chronology, or can be converted to a {@code LocalDate}.
+ * chronology, or can be converted to a {@code LocalDate} .
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code YearMonth::from}.
+ * to be used in queries via method reference, {@code YearMonth::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the year-month, not null
* @throws DateTimeException
- * if unable to convert to a { @code YearMonth}
+ * if unable to convert to a {@code YearMonth}
*/
def from(temporal: TemporalAccessor): YearMonth = {
var _temporal = temporal
@@ -209,10 +209,10 @@ object YearMonth {
}
/**
- * Obtains an instance of {@code YearMonth} from a text string such as {@code 2007-12}.
+ * Obtains an instance of {@code YearMonth} from a text string such as {@code 2007-12} .
*
- * The string must represent a valid year-month. The format must be {@code yyyy-MM}. Years outside
- * the range 0000 to 9999 must be prefixed by the plus or minus symbol.
+ * The string must represent a valid year-month. The format must be {@code yyyy-MM} . Years
+ * outside the range 0000 to 9999 must be prefixed by the plus or minus symbol.
*
* @param text
* the text to parse such as "2007-12", not null
@@ -293,7 +293,7 @@ final class YearMonth private (private val year: Int, private val month: Int)
* YEAR_OF_ERA}
*
* @param zoneId
* the time-zone ID, not null
@@ -256,20 +256,20 @@ object ZoneId {
* Obtains an instance of {@code ZoneId} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code ZoneId}.
+ * converts the arbitrary temporal object to an instance of {@code ZoneId} .
*
* The conversion will try to obtain the zone in a way that favours region-based zones over
- * offset-based zones using {@link TemporalQueries#zone()}.
+ * offset-based zones using {@link TemporalQueries#zone()} .
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code ZoneId::from}.
+ * to be used in queries via method reference, {@code ZoneId::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the zone ID, not null
* @throws DateTimeException
- * if unable to convert to a { @code ZoneId}
+ * if unable to convert to a {@code ZoneId}
*/
def from(temporal: TemporalAccessor): ZoneId = {
val obj: ZoneId = temporal.query(TemporalQueries.zone)
@@ -282,17 +282,17 @@ object ZoneId {
}
/**
- * A time-zone ID, such as {@code Europe/Paris}.
+ * A time-zone ID, such as {@code Europe/Paris} .
*
* A {@code ZoneId} is used to identify the rules used to convert between an {@link Instant} and a
- * {@link LocalDateTime}. There are two distinct types of ID:
+ * most IDs from {@link java.util.TimeZone} . [A-Za-z][A-Za-z0-9~/._+-]+
otherwise a {@code DateTimeException} is
* thrown. If the zone ID is not in the configured set of IDs, {@code ZoneRulesException} is
* thrown. The detailed format of the region ID depends on the group supplying the data. The
* default set of data is supplied by the IANA Time Zone Database (TZDB). This has region IDs of
* the form '{area}/{city}', such as 'Europe/Paris' or 'America/New_York'. This is compatible with
- * most IDs from {@link java.util.TimeZone}.
Most fixed offsets are represented by {@link ZoneOffset} . Calling
* {@link #normalized()} on any {@code ZoneId} will ensure that a fixed offset ID will be
- * represented as a {@code ZoneOffset}.
+ * represented as a {@code ZoneOffset} .
*
- * The actual rules, describing when and how the offset changes, are defined by {@link ZoneRules}.
+ * The actual rules, describing when and how the offset changes, are defined by {@link ZoneRules} .
* This class is simply an ID used to obtain the underlying rules. This approach is taken because
* rules are defined by governments and change frequently, whereas the ID is stable.
*
@@ -302,7 +302,7 @@ object ZoneId {
*
*
Most fixed offsets are represented by {@link ZoneOffset}. Calling
+ * UTC/Greenwich apply Time-zone IDs
The ID is unique within the system. There are three types of ID.
*
- * The simplest type of ID is that from {@code ZoneOffset}. This consists of 'Z' and IDs starting
+ * The simplest type of ID is that from {@code ZoneOffset} . This consists of 'Z' and IDs starting
* with '+' or '-'.
*
* The next type of ID are offset-style IDs with some form of prefix, such as 'GMT+2' or
@@ -312,8 +312,8 @@ object ZoneId {
*
* The third type of ID are region-based IDs. A region-based ID must be of two or more characters,
* and not start with 'UTC', 'GMT', 'UT' '+' or '-'. Region-based IDs are defined by configuration,
- * see {@link ZoneRulesProvider}. The configuration focuses on providing the lookup from the ID to
- * the underlying {@code ZoneRules}.
+ * see {@link ZoneRulesProvider} . The configuration focuses on providing the lookup from the ID to
+ * the underlying {@code ZoneRules} .
*
* Time-zone rules are defined by governments and change frequently. There are a number of
* organizations, known here as groups, that monitor time-zone changes and collate them. The default
@@ -336,10 +336,10 @@ object ZoneId {
* A {@code ZoneId} can be deserialized in a Java Runtime where the ID is unknown. For example, if a
* server-side Java Runtime has been updated with a new zone ID, but the client-side Java Runtime
* has not been updated. In this case, the {@code ZoneId} object will exist, and can be queried
- * using {@code getId}, {@code equals}, {@code hashCode}, {@code toString}, {@code getDisplayName}
- * and {@code normalized}. However, any call to {@code getRules} will fail with {@code
- * ZoneRulesException}. This approach is designed to allow a {@link ZonedDateTime} to be loaded and
- * queried, but not modified, on a Java Runtime with incomplete time-zone information.
+ * using {@code getId} , {@code equals} , {@code hashCode} , {@code toString} ,
+ * {@code getDisplayName} and {@code normalized} . However, any call to {@code getRules} will fail
+ * with {@code ZoneRulesException}. This approach is designed to allow a {@link ZonedDateTime} to be
+ * loaded and queried, but not modified, on a Java Runtime with incomplete time-zone information.
*
* Specification for implementors
This abstract class has two implementations, both of
* which are immutable and thread-safe. One implementation models region-based IDs, the other is
@@ -372,9 +372,9 @@ abstract class ZoneId private[bp] () extends Serializable {
*
* A time-zone can be invalid if it is deserialized in a Java Runtime which does not have the same
* rules loaded as the Java Runtime that stored it. In this case, calling this method will throw a
- * {@code ZoneRulesException}.
+ * {@code ZoneRulesException} .
*
- * The rules are supplied by {@link ZoneRulesProvider}. An advanced provider may support dynamic
+ * The rules are supplied by {@link ZoneRulesProvider} . An advanced provider may support dynamic
* updates to the rules without restarting the Java Runtime. If so, then the result of this method
* may change over time. Each individual call will be still remain thread-safe.
*
@@ -407,7 +407,7 @@ abstract class ZoneId private[bp] () extends Serializable {
.appendZoneText(style)
.toFormatter(locale)
.format(new TemporalAccessor() {
- def isSupported(field: TemporalField): Boolean = false
+ def isSupported(field: TemporalField): Boolean = false
def getLong(field: TemporalField): Long =
throw new UnsupportedTemporalTypeException(s"Unsupported field: $field")
override def query[R](query: TemporalQuery[R]): R =
@@ -467,7 +467,7 @@ abstract class ZoneId private[bp] () extends Serializable {
override def hashCode: Int = getId.hashCode
/**
- * Outputs this zone as a {@code String}, using the ID.
+ * Outputs this zone as a {@code String} , using the ID.
*
* @return
* a string representation of this time-zone ID, not null
diff --git a/core/shared/src/main/scala/org/threeten/bp/ZoneOffset.scala b/core/shared/src/main/scala/org/threeten/bp/ZoneOffset.scala
index b82705208..0d356c456 100644
--- a/core/shared/src/main/scala/org/threeten/bp/ZoneOffset.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/ZoneOffset.scala
@@ -82,7 +82,7 @@ object ZoneOffset {
* Obtains an instance of {@code ZoneOffset} using the ID.
*
* This method parses the string ID of a {@code ZoneOffset} to return an instance. The parsing
- * accepts all the formats generated by {@link #getId()}, plus some additional formats:
+ * accepts all the formats generated by {@link #getId()} , plus some additional formats:
*
Specification for implementors
This class is immutable and thread-safe.
@@ -457,7 +457,7 @@ final class ZoneOffset private (private val totalSeconds: Int)
* If the field is a {@link ChronoField} then the query is implemented here. The {@code
* OFFSET_SECONDS} field returns true. All other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -479,9 +479,9 @@ final class ZoneOffset private (private val totalSeconds: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -501,7 +501,7 @@ final class ZoneOffset private (private val totalSeconds: Int)
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this offset as an {@code int}.
+ * Gets the value of the specified field from this offset as an {@code int} .
*
* This queries this offset for the value for the specified field. The returned value will always
* be within the valid range of values for the field. If it is not possible to return the value,
@@ -509,9 +509,9 @@ final class ZoneOffset private (private val totalSeconds: Int)
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@code
* OFFSET_SECONDS} field returns the value of the offset. All other {@code ChronoField} instances
- * will throw a {@code DateTimeException}.
+ * will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -533,16 +533,16 @@ final class ZoneOffset private (private val totalSeconds: Int)
range(field).checkValidIntValue(getLong(field), field)
/**
- * Gets the value of the specified field from this offset as a {@code long}.
+ * Gets the value of the specified field from this offset as a {@code long} .
*
* This queries this offset for the value for the specified field. If it is not possible to return
* the value, because the field is not supported or for some other reason, an exception is thrown.
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@code
* OFFSET_SECONDS} field returns the value of the offset. All other {@code ChronoField} instances
- * will throw a {@code DateTimeException}.
+ * will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -628,16 +628,16 @@ final class ZoneOffset private (private val totalSeconds: Int)
*
* The offsets are compared in the order that they occur for the same time of day around the
* world. Thus, an offset of {@code +10:00} comes before an offset of {@code +09:00} and so on
- * down to {@code -18:00}.
+ * down to {@code -18:00} .
*
- * The comparison is "consistent with equals", as defined by {@link Comparable}.
+ * The comparison is "consistent with equals", as defined by {@link Comparable} .
*
* @param other
* the other date to compare to, not null
* @return
* the comparator value, negative if less, postive if greater
* @throws NullPointerException
- * if { @code other} is null
+ * if {@code other} is null
*/
def compare(other: ZoneOffset): Int = other.totalSeconds - totalSeconds
@@ -669,7 +669,7 @@ final class ZoneOffset private (private val totalSeconds: Int)
override def hashCode: Int = totalSeconds
/**
- * Outputs this offset as a {@code String}, using the normalized ID.
+ * Outputs this offset as a {@code String} , using the normalized ID.
*
* @return
* a string representation of this offset, not null
diff --git a/core/shared/src/main/scala/org/threeten/bp/ZoneRegion.scala b/core/shared/src/main/scala/org/threeten/bp/ZoneRegion.scala
index b5a6544c8..3536c6ff3 100644
--- a/core/shared/src/main/scala/org/threeten/bp/ZoneRegion.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/ZoneRegion.scala
@@ -85,7 +85,7 @@ private object ZoneRegion {
* (TZDB), which defines regions such as 'Europe/Paris' and 'Asia/Tokyo'.
*
* The region identifier, modeled by this class, is distinct from the underlying rules, modeled by
- * {@link ZoneRules}. The rules are defined by governments and change frequently. By contrast, the
+ * {@link ZoneRules} . The rules are defined by governments and change frequently. By contrast, the
* region identifier is well-defined and long-lived. This separation also allows rules to be shared
* between regions if appropriate.
*
diff --git a/core/shared/src/main/scala/org/threeten/bp/ZonedDateTime.scala b/core/shared/src/main/scala/org/threeten/bp/ZonedDateTime.scala
index 60cfe322c..04691e931 100644
--- a/core/shared/src/main/scala/org/threeten/bp/ZonedDateTime.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/ZonedDateTime.scala
@@ -93,7 +93,7 @@ object ZonedDateTime {
* be set based on the time-zone in the clock.
*
* Using this method allows the use of an alternate clock for testing. The alternate clock may be
- * introduced using {@link Clock dependency injection}.
+ * introduced using {@link Clock dependency injection} .
*
* @param clock
* the clock to use, not null
@@ -287,7 +287,7 @@ object ZonedDateTime {
}
/**
- * Obtains an instance of {@code ZonedDateTime} from an {@code Instant}.
+ * Obtains an instance of {@code ZonedDateTime} from an {@code Instant} .
*
* This creates a zoned date-time with the same instant as that specified. Calling {@link
* #toInstant()} will return an instant equal to the one used here.
@@ -315,14 +315,14 @@ object ZonedDateTime {
* date-time and offset.
*
* This creates a zoned date-time by {@link LocalDateTime#toInstant(ZoneOffset) combining} the
- * {@code LocalDateTime} and {@code ZoneOffset}. This combination uniquely specifies an instant
+ * {@code LocalDateTime} and {@code ZoneOffset} . This combination uniquely specifies an instant
* without ambiguity.
*
* Converting an instant to a zoned date-time is simple as there is only one valid offset for each
* instant. If the valid offset is different to the offset specified, the the date-time and offset
* of the zoned date-time will differ from those specified.
*
- * If the {@code ZoneId} to be used is a {@code ZoneOffset}, this method is equivalent to {@link
+ * If the {@code ZoneId} to be used is a {@code ZoneOffset} , this method is equivalent to {@link
* #of(LocalDateTime, ZoneId)}.
*
* @param localDateTime
@@ -401,21 +401,21 @@ object ZonedDateTime {
* Obtains an instance of {@code ZonedDateTime} from a temporal object.
*
* A {@code TemporalAccessor} represents some form of date and time information. This factory
- * converts the arbitrary temporal object to an instance of {@code ZonedDateTime}.
+ * converts the arbitrary temporal object to an instance of {@code ZonedDateTime} .
*
- * The conversion will first obtain a {@code ZoneId}. It will then try to obtain an instant. If
+ * The conversion will first obtain a {@code ZoneId} . It will then try to obtain an instant. If
* that fails it will try to obtain a local date-time. The zoned date time will either be a
* combination of {@code ZoneId} and instant, or {@code ZoneId} and local date-time.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used in queries via method reference, {@code ZonedDateTime::from}.
+ * to be used in queries via method reference, {@code ZonedDateTime::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the zoned date-time, not null
* @throws DateTimeException
- * if unable to convert to an { @code ZonedDateTime}
+ * if unable to convert to an {@code ZonedDateTime}
*/
def from(temporal: TemporalAccessor): ZonedDateTime =
temporal match {
@@ -494,11 +494,11 @@ object ZonedDateTime {
* ZonedDateTime}.
*
* This class handles conversion from the local time-line of {@code LocalDateTime} to the instant
- * time-line of {@code Instant}. The difference between the two time-lines is the offset from
- * UTC/Greenwich, represented by a {@code ZoneOffset}.
+ * time-line of {@code Instant} . The difference between the two time-lines is the offset from
+ * UTC/Greenwich, represented by a {@code ZoneOffset} .
*
* Converting between the two time-lines involves calculating the offset using the {@link ZoneRules
- * rules} accessed from the {@code ZoneId}. Obtaining the offset for an instant is simple, as there
+ * rules} accessed from the {@code ZoneId} . Obtaining the offset for an instant is simple, as there
* is exactly one valid offset for each instant. By contrast, obtaining the offset for a local
* date-time is not straightforward. There are three cases:
* All other {@code ChronoField} instances will return false.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the field is supported is determined by the field.
*
@@ -635,9 +635,9 @@ final class ZonedDateTime(
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return appropriate range instances. All
- * other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.rangeRefinedBy(TemporalAccessor)} passing {@code this} as the
* argument. Whether the range can be obtained is determined by the field.
*
@@ -658,7 +658,7 @@ final class ZonedDateTime(
field.rangeRefinedBy(this)
/**
- * Gets the value of the specified field from this date-time as an {@code int}.
+ * Gets the value of the specified field from this date-time as an {@code int} .
*
* This queries this date-time for the value for the specified field. The returned value will
* always be within the valid range of values for the field. If it is not possible to return the
@@ -666,12 +666,12 @@ final class ZonedDateTime(
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this date-time,
- * except {@code NANO_OF_DAY}, {@code MICRO_OF_DAY}, {@code EPOCH_DAY}, {@code EPOCH_MONTH} and
+ * except {@code NANO_OF_DAY} , {@code MICRO_OF_DAY} , {@code EPOCH_DAY} , {@code EPOCH_MONTH} and
* {@code INSTANT_SECONDS} which are too large to fit in an {@code int} and throw a {@code
* DateTimeException}. All other {@code ChronoField} instances will throw a {@code
* DateTimeException}.
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -697,7 +697,7 @@ final class ZonedDateTime(
}
/**
- * Gets the value of the specified field from this date-time as a {@code long}.
+ * Gets the value of the specified field from this date-time as a {@code long} .
*
* This queries this date-time for the value for the specified field. If it is not possible to
* return the value, because the field is not supported or for some other reason, an exception is
@@ -705,9 +705,9 @@ final class ZonedDateTime(
*
* If the field is a {@link ChronoField} then the query is implemented here. The {@link
* #isSupported(TemporalField) supported fields} will return valid values based on this date-time.
- * All other {@code ChronoField} instances will throw a {@code DateTimeException}.
+ * All other {@code ChronoField} instances will throw a {@code DateTimeException} .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument.
* Whether the value can be obtained, and what the value represents, is determined by the field.
*
@@ -756,7 +756,7 @@ final class ZonedDateTime(
* This instance is immutable and unaffected by this method call.
*
* @return
- * a { @code ZonedDateTime} based on this date-time with the earlier offset, not null
+ * a {@code ZonedDateTime} based on this date-time with the earlier offset, not null
*/
def withEarlierOffsetAtOverlap: ZonedDateTime = {
val trans: ZoneOffsetTransition = getZone.getRules.getTransition(dateTime)
@@ -782,7 +782,7 @@ final class ZonedDateTime(
* This instance is immutable and unaffected by this method call.
*
* @return
- * a { @code ZonedDateTime} based on this date-time with the later offset, not null
+ * a {@code ZonedDateTime} based on this date-time with the later offset, not null
*/
def withLaterOffsetAtOverlap: ZonedDateTime = {
val trans: ZoneOffsetTransition = getZone.getRules.getTransition(toLocalDateTime)
@@ -802,9 +802,9 @@ final class ZonedDateTime(
* This returns the zone ID. This identifies the time-zone {@link ZoneRules rules} that determine
* when and how the offset from UTC/Greenwich changes.
*
- * The zone ID may be same as the {@link #getOffset() offset}. If this is true, then any future
+ * The zone ID may be same as the {@link #getOffset() offset} . If this is true, then any future
* calculations, such as addition or subtraction, have no complex edge cases due to time-zone
- * rules. See also {@link #withFixedOffsetZone()}.
+ * rules. See also {@link #withFixedOffsetZone()} .
*
* @return
* the time-zone, not null
@@ -819,14 +819,14 @@ final class ZonedDateTime(
* changed if it is invalid for the new zone, determined using the same approach as {@link
* #ofLocal(LocalDateTime, ZoneId, ZoneOffset)}.
*
- * To change the zone and adjust the local date-time, use {@link #withZoneSameInstant(ZoneId)}.
+ * To change the zone and adjust the local date-time, use {@link #withZoneSameInstant(ZoneId)} .
*
* This instance is immutable and unaffected by this method call.
*
* @param zone
* the time-zone to change to, not null
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested zone, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested zone, not null
*/
def withZoneSameLocal(zone: ZoneId): ZonedDateTime = {
Objects.requireNonNull(zone, "zone")
@@ -842,12 +842,12 @@ final class ZonedDateTime(
* This method is based on retaining the same instant, thus gaps and overlaps in the local
* time-line have no effect on the result.
*
- * To change the offset while keeping the local time, use {@link #withZoneSameLocal(ZoneId)}.
+ * To change the offset while keeping the local time, use {@link #withZoneSameLocal(ZoneId)} .
*
* @param zone
* the time-zone to change to, not null
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested zone, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested zone, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -860,18 +860,18 @@ final class ZonedDateTime(
/**
* Returns a copy of this date-time with the zone ID set to the offset.
*
- * This returns a zoned date-time where the zone ID is the same as {@link #getOffset()}. The local
- * date-time, offset and instant of the result will be the same as in this date-time.
+ * This returns a zoned date-time where the zone ID is the same as {@link #getOffset()} . The
+ * local date-time, offset and instant of the result will be the same as in this date-time.
*
* Setting the date-time to a fixed single offset means that any future calculations, such as
* addition or subtraction, have no complex edge cases due to time-zone rules. This might also be
* useful when sending a zoned date-time across a network, as most protocols, such as ISO-8601,
* only handle offsets, and not region-based zone IDs.
*
- * This is equivalent to {@code ZonedDateTime.of(zdt.getDateTime(), zdt.getOffset())}.
+ * This is equivalent to {@code ZonedDateTime.of(zdt.getDateTime(), zdt.getOffset())} .
*
* @return
- * a { @code ZonedDateTime} with the zone ID set to the offset, not null
+ * a {@code ZonedDateTime} with the zone ID set to the offset, not null
*/
def withFixedOffsetZone: ZonedDateTime =
if (this.zone == offset) this
@@ -882,8 +882,8 @@ final class ZonedDateTime(
*
* This method returns the primitive {@code int} value for the year.
*
- * The year returned by this method is proleptic as per {@code get(YEAR)}. To obtain the
- * year-of-era, use {@code get(YEAR_OF_ERA}.
+ * The year returned by this method is proleptic as per {@code get(YEAR)} . To obtain the
+ * year-of-era, use {@code get(YEAR_OF_ERA} .
*
* @return
* the year, from MIN_YEAR to MAX_YEAR
@@ -894,7 +894,7 @@ final class ZonedDateTime(
* Gets the month-of-year field from 1 to 12.
*
* This method returns the month as an {@code int} from 1 to 12. Application code is frequently
- * clearer if the enum {@link Month} is used by calling {@link #getMonth()}.
+ * clearer if the enum {@link Month} is used by calling {@link #getMonth()} .
*
* @return
* the month-of-year, from 1 to 12
@@ -908,7 +908,7 @@ final class ZonedDateTime(
*
* This method returns the enum {@link Month} for the month. This avoids confusion as to what
* {@code int} values mean. If you need access to the primitive {@code int} value then the enum
- * provides the {@link Month#getValue() int value}.
+ * provides the {@link Month#getValue() int value} .
*
* @return
* the month-of-year, not null
@@ -938,13 +938,13 @@ final class ZonedDateTime(
def getDayOfYear: Int = dateTime.getDayOfYear
/**
- * Gets the day-of-week field, which is an enum {@code DayOfWeek}.
+ * Gets the day-of-week field, which is an enum {@code DayOfWeek} .
*
* This method returns the enum {@link DayOfWeek} for the day-of-week. This avoids confusion as to
* what {@code int} values mean. If you need access to the primitive {@code int} value then the
- * enum provides the {@link DayOfWeek#getValue() int value}.
+ * enum provides the {@link DayOfWeek#getValue() int value} .
*
- * Additional information can be obtained from the {@code DayOfWeek}. This includes textual names
+ * Additional information can be obtained from the {@code DayOfWeek} . This includes textual names
* of the values.
*
* @return
@@ -987,15 +987,15 @@ final class ZonedDateTime(
/**
* Returns an adjusted copy of this date-time.
*
- * This returns a new {@code ZonedDateTime}, based on this one, with the date-time adjusted. The
+ * This returns a new {@code ZonedDateTime} , based on this one, with the date-time adjusted. The
* adjustment takes place using the specified adjuster strategy object. Read the documentation of
* the adjuster to understand what adjustment will be made.
*
* A simple adjuster might simply set the one of the fields, such as the year field. A more
* complex adjuster might set the date to the last day of the month. A selection of common
- * adjustments is provided in {@link TemporalAdjusters}. These include finding the "last day of
+ * adjustments is provided in {@link TemporalAdjusters} . These include finding the "last day of
* the month" and "next Wednesday". Key date-time classes also implement the {@code
- * TemporalAdjuster} interface, such as {@link Month} and {@link MonthDay}. The adjuster is
+ * TemporalAdjuster} interface, such as {@link Month} and {@link MonthDay} . The adjuster is
* responsible for handling special cases, such as the varying lengths of month and leap years.
*
* For example this code returns a date on the last day of July: Specification for implementors
A {@code ZonedDateTime} holds state equivalent to three
- * separate objects, a {@code LocalDateTime}, a {@code ZoneId} and the resolved {@code ZoneOffset}.
- * The offset and local date-time are used to define an instant when necessary. The zone ID is used
- * to obtain the rules for how and when the offset changes. The offset cannot be freely set, as the
- * zone controls which offsets are valid.
+ * separate objects, a {@code LocalDateTime} , a {@code ZoneId} and the resolved {@code ZoneOffset}
+ * . The offset and local date-time are used to define an instant when necessary. The zone ID is
+ * used to obtain the rules for how and when the offset changes. The offset cannot be freely set, as
+ * the zone controls which offsets are valid.
*
* This class is immutable and thread-safe.
*
@@ -602,7 +602,7 @@ final class ZonedDateTime(
* import static
@@ -1003,13 +1003,13 @@ final class ZonedDateTime(
*
* result = zonedDateTime.with(JULY).with(lastDayOfMonth());
*
- * The classes {@link LocalDate} and {@link LocalTime} implement {@code TemporalAdjuster}, thus
+ * The classes {@link LocalDate} and {@link LocalTime} implement {@code TemporalAdjuster} , thus
* this method can be used to change the date, time or offset: result =
* zonedDateTime.with(date); result = zonedDateTime.with(time);
*
* {@link ZoneOffset} also implements {@code TemporalAdjuster} however it is less likely that
* setting the offset will have the effect you expect. When an offset is passed in, the local
- * date-time is combined with the new offset to form an {@code Instant}. The instant and original
+ * date-time is combined with the new offset to form an {@code Instant} . The instant and original
* zone are then used to create the result. This algorithm means that it is quite likely that the
* output has a different offset to the specified offset. It will however work correctly when
* passing in the offset applicable for the instant of the zoned date-time, and will work
@@ -1025,7 +1025,7 @@ final class ZonedDateTime(
* @param adjuster
* the adjuster to use, not null
* @return
- * a { @code ZonedDateTime} based on { @code this} with the adjustment made, not null
+ * a {@code ZonedDateTime} based on {@code this} with the adjustment made, not null
* @throws DateTimeException
* if the adjustment cannot be made
* @throws ArithmeticException
@@ -1044,8 +1044,8 @@ final class ZonedDateTime(
/**
* Returns a copy of this date-time with the specified field set to a new value.
*
- * This returns a {@code ZonedDateTime}, based on this one, with the value for the specified field
- * changed. This can be used to change any supported field, such as the year, month or
+ * This returns a {@code ZonedDateTime} , based on this one, with the value for the specified
+ * field changed. This can be used to change any supported field, such as the year, month or
* day-of-month. If it is not possible to set the value, because the field is not supported or for
* some other reason, an exception is thrown.
*
@@ -1069,15 +1069,16 @@ final class ZonedDateTime(
* value is outside the valid range then a {@code DateTimeException} will be thrown.
*
* The other {@link #isSupported(TemporalField) supported fields} will behave as per the matching
- * method on {@link LocalDateTime#with(TemporalField, long) LocalDateTime}. The zone is not part
- * of the calculation and will be unchanged. When converting back to {@code ZonedDateTime}, if the
- * local date-time is in an overlap, then the offset will be retained if possible, otherwise the
- * earlier offset will be used. If in a gap, the local date-time will be adjusted forward by the
- * length of the gap.
+ * method on {@link LocalDateTime#with(TemporalField, long) LocalDateTime} . The zone is not part
+ * of the calculation and will be unchanged. When converting back to {@code ZonedDateTime} , if
+ * the local date-time is in an overlap, then the offset will be retained if possible, otherwise
+ * the earlier offset will be used. If in a gap, the local date-time will be adjusted forward by
+ * the length of the gap.
*
- * All other {@code ChronoField} instances will throw an {@code UnsupportedTemporalTypeException}.
+ * All other {@code ChronoField} instances will throw an {@code UnsupportedTemporalTypeException}
+ * .
*
- * If the field is not a {@code ChronoField}, then the result of this method is obtained by
+ * If the field is not a {@code ChronoField} , then the result of this method is obtained by
* invoking {@code TemporalField.adjustInto(Temporal, long)} passing {@code this} as the argument.
* In this case, the field determines whether and how to adjust the instant.
*
@@ -1088,7 +1089,7 @@ final class ZonedDateTime(
* @param newValue
* the new value of the field in the result
* @return
- * a { @code ZonedDateTime} based on { @code this} with the specified field set, not null
+ * a {@code ZonedDateTime} based on {@code this} with the specified field set, not null
* @throws DateTimeException
* if the field cannot be set
* @throws UnsupportedTemporalTypeException
@@ -1113,10 +1114,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the year value altered.
*
* This operates on the local time-line, {@link LocalDateTime#withYear(int) changing the year} of
- * the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID
+ * the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID
* to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1125,7 +1126,7 @@ final class ZonedDateTime(
* @param year
* the year to set in the result, from MIN_YEAR to MAX_YEAR
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested year, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested year, not null
* @throws DateTimeException
* if the year value is invalid
*/
@@ -1135,10 +1136,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the month-of-year value altered.
*
* This operates on the local time-line, {@link LocalDateTime#withMonth(int) changing the month}
- * of the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone
+ * of the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone
* ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1147,7 +1148,7 @@ final class ZonedDateTime(
* @param month
* the month-of-year to set in the result, from 1 (January) to 12 (December)
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested month, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested month, not null
* @throws DateTimeException
* if the month-of-year value is invalid
*/
@@ -1157,10 +1158,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the day-of-month value altered.
*
* This operates on the local time-line, {@link LocalDateTime#withDayOfMonth(int) changing the
- * day-of-month} of the local date-time. This is then converted back to a {@code ZonedDateTime},
+ * day-of-month} of the local date-time. This is then converted back to a {@code ZonedDateTime} ,
* using the zone ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1169,7 +1170,7 @@ final class ZonedDateTime(
* @param dayOfMonth
* the day-of-month to set in the result, from 1 to 28-31
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested day, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested day, not null
* @throws DateTimeException
* if the day-of-month value is invalid
* @throws DateTimeException
@@ -1182,10 +1183,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the day-of-year altered.
*
* This operates on the local time-line, {@link LocalDateTime#withDayOfYear(int) changing the
- * day-of-year} of the local date-time. This is then converted back to a {@code ZonedDateTime},
+ * day-of-year} of the local date-time. This is then converted back to a {@code ZonedDateTime} ,
* using the zone ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1194,7 +1195,7 @@ final class ZonedDateTime(
* @param dayOfYear
* the day-of-year to set in the result, from 1 to 365-366
* @return
- * a { @code ZonedDateTime} based on this date with the requested day, not null
+ * a {@code ZonedDateTime} based on this date with the requested day, not null
* @throws DateTimeException
* if the day-of-year value is invalid
* @throws DateTimeException
@@ -1206,10 +1207,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the hour-of-day value altered.
*
* This operates on the local time-line, {@link LocalDateTime#withHour(int) changing the time} of
- * the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID
+ * the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID
* to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1218,7 +1219,7 @@ final class ZonedDateTime(
* @param hour
* the hour-of-day to set in the result, from 0 to 23
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested hour, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested hour, not null
* @throws DateTimeException
* if the hour value is invalid
*/
@@ -1228,10 +1229,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the minute-of-hour value altered.
*
* This operates on the local time-line, {@link LocalDateTime#withMinute(int) changing the time}
- * of the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone
+ * of the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone
* ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1240,7 +1241,7 @@ final class ZonedDateTime(
* @param minute
* the minute-of-hour to set in the result, from 0 to 59
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested minute, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested minute, not null
* @throws DateTimeException
* if the minute value is invalid
*/
@@ -1250,10 +1251,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the second-of-minute value altered.
*
* This operates on the local time-line, {@link LocalDateTime#withSecond(int) changing the time}
- * of the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone
+ * of the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone
* ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1262,7 +1263,7 @@ final class ZonedDateTime(
* @param second
* the second-of-minute to set in the result, from 0 to 59
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested second, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested second, not null
* @throws DateTimeException
* if the second value is invalid
*/
@@ -1272,10 +1273,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the nano-of-second value altered.
*
* This operates on the local time-line, {@link LocalDateTime#withNano(int) changing the time} of
- * the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID
+ * the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID
* to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1284,7 +1285,7 @@ final class ZonedDateTime(
* @param nanoOfSecond
* the nano-of-second to set in the result, from 0 to 999,999,999
* @return
- * a { @code ZonedDateTime} based on this date-time with the requested nanosecond, not null
+ * a {@code ZonedDateTime} based on this date-time with the requested nanosecond, not null
* @throws DateTimeException
* if the nano value is invalid
*/
@@ -1299,13 +1300,13 @@ final class ZonedDateTime(
*
* The unit must have a {@linkplain TemporalUnit#getDuration() duration} that divides into the
* length of a standard day without remainder. This includes all supplied time units on {@link
- * ChronoUnit} and {@link ChronoUnit#DAYS DAYS}. Other units throw an exception.
+ * ChronoUnit} and {@link ChronoUnit#DAYS DAYS} . Other units throw an exception.
*
* This operates on the local time-line, {@link LocalDateTime#truncatedTo(TemporalUnit)
* truncating} the underlying local date-time. This is then converted back to a {@code
* ZonedDateTime}, using the zone ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1314,7 +1315,7 @@ final class ZonedDateTime(
* @param unit
* the unit to truncate to, not null
* @return
- * a { @code ZonedDateTime} based on this date-time with the time truncated, not null
+ * a {@code ZonedDateTime} based on this date-time with the time truncated, not null
* @throws DateTimeException
* if unable to truncate
*/
@@ -1326,14 +1327,14 @@ final class ZonedDateTime(
* This method returns a new date-time based on this time with the specified period added. The
* amount is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #plus(long, TemporalUnit)}.
+ * typically calls back to {@link #plus(long, TemporalUnit)} .
*
* This instance is immutable and unaffected by this method call.
*
* @param amount
* the amount to add, not null
* @return
- * a { @code ZonedDateTime} based on this date-time with the addition made, not null
+ * a {@code ZonedDateTime} based on this date-time with the addition made, not null
* @throws DateTimeException
* if the addition cannot be made
* @throws ArithmeticException
@@ -1367,7 +1368,7 @@ final class ZonedDateTime(
* @param unit
* the unit of the period to add, not null
* @return
- * a { @code ZonedDateTime} based on this date-time with the specified period added, not null
+ * a {@code ZonedDateTime} based on this date-time with the specified period added, not null
* @throws DateTimeException
* if the unit cannot be added to this type
*/
@@ -1382,10 +1383,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in years added.
*
* This operates on the local time-line, {@link LocalDateTime#plusYears(long) adding years} to the
- * local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID to
+ * local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID to
* obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1394,7 +1395,7 @@ final class ZonedDateTime(
* @param years
* the years to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the years added, not null
+ * a {@code ZonedDateTime} based on this date-time with the years added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1404,10 +1405,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in months added.
*
* This operates on the local time-line, {@link LocalDateTime#plusMonths(long) adding months} to
- * the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID
+ * the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID
* to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1416,7 +1417,7 @@ final class ZonedDateTime(
* @param months
* the months to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the months added, not null
+ * a {@code ZonedDateTime} based on this date-time with the months added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1426,10 +1427,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in weeks added.
*
* This operates on the local time-line, {@link LocalDateTime#plusWeeks(long) adding weeks} to the
- * local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID to
+ * local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID to
* obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1438,7 +1439,7 @@ final class ZonedDateTime(
* @param weeks
* the weeks to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the weeks added, not null
+ * a {@code ZonedDateTime} based on this date-time with the weeks added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1448,10 +1449,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in days added.
*
* This operates on the local time-line, {@link LocalDateTime#plusDays(long) adding days} to the
- * local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID to
+ * local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID to
* obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1460,7 +1461,7 @@ final class ZonedDateTime(
* @param days
* the days to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the days added, not null
+ * a {@code ZonedDateTime} based on this date-time with the days added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1485,7 +1486,7 @@ final class ZonedDateTime(
* @param hours
* the hours to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the hours added, not null
+ * a {@code ZonedDateTime} based on this date-time with the hours added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1503,7 +1504,7 @@ final class ZonedDateTime(
* @param minutes
* the minutes to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the minutes added, not null
+ * a {@code ZonedDateTime} based on this date-time with the minutes added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1521,7 +1522,7 @@ final class ZonedDateTime(
* @param seconds
* the seconds to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the seconds added, not null
+ * a {@code ZonedDateTime} based on this date-time with the seconds added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1539,7 +1540,7 @@ final class ZonedDateTime(
* @param nanos
* the nanos to add, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the nanoseconds added, not null
+ * a {@code ZonedDateTime} based on this date-time with the nanoseconds added, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1551,14 +1552,14 @@ final class ZonedDateTime(
* This method returns a new date-time based on this time with the specified period subtracted.
* The amount is typically {@link Period} but may be any other type implementing the {@link
* TemporalAmount} interface. The calculation is delegated to the specified adjuster, which
- * typically calls back to {@link #minus(long, TemporalUnit)}.
+ * typically calls back to {@link #minus(long, TemporalUnit)} .
*
* This instance is immutable and unaffected by this method call.
*
* @param amount
* the amount to subtract, not null
* @return
- * a { @code ZonedDateTime} based on this date-time with the subtraction made, not null
+ * a {@code ZonedDateTime} based on this date-time with the subtraction made, not null
* @throws DateTimeException
* if the subtraction cannot be made
* @throws ArithmeticException
@@ -1592,7 +1593,7 @@ final class ZonedDateTime(
* @param unit
* the unit of the period to subtract, not null
* @return
- * a { @code ZonedDateTime} based on this date-time with the specified period subtracted, not
+ * a {@code ZonedDateTime} based on this date-time with the specified period subtracted, not
* null
* @throws DateTimeException
* if the unit cannot be added to this type
@@ -1605,10 +1606,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in years subtracted.
*
* This operates on the local time-line, {@link LocalDateTime#minusYears(long) subtracting years}
- * to the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone
+ * to the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone
* ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1617,7 +1618,7 @@ final class ZonedDateTime(
* @param years
* the years to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the years subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the years subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1629,10 +1630,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in months subtracted.
*
* This operates on the local time-line, {@link LocalDateTime#minusMonths(long) subtracting
- * months} to the local date-time. This is then converted back to a {@code ZonedDateTime}, using
+ * months} to the local date-time. This is then converted back to a {@code ZonedDateTime} , using
* the zone ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1641,7 +1642,7 @@ final class ZonedDateTime(
* @param months
* the months to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the months subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the months subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1653,10 +1654,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in weeks subtracted.
*
* This operates on the local time-line, {@link LocalDateTime#minusWeeks(long) subtracting weeks}
- * to the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone
+ * to the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone
* ID to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1665,7 +1666,7 @@ final class ZonedDateTime(
* @param weeks
* the weeks to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the weeks subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the weeks subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1677,10 +1678,10 @@ final class ZonedDateTime(
* Returns a copy of this {@code ZonedDateTime} with the specified period in days subtracted.
*
* This operates on the local time-line, {@link LocalDateTime#minusDays(long) subtracting days} to
- * the local date-time. This is then converted back to a {@code ZonedDateTime}, using the zone ID
+ * the local date-time. This is then converted back to a {@code ZonedDateTime} , using the zone ID
* to obtain the offset.
*
- * When converting back to {@code ZonedDateTime}, if the local date-time is in an overlap, then
+ * When converting back to {@code ZonedDateTime} , if the local date-time is in an overlap, then
* the offset will be retained if possible, otherwise the earlier offset will be used. If in a
* gap, the local date-time will be adjusted forward by the length of the gap.
*
@@ -1689,7 +1690,7 @@ final class ZonedDateTime(
* @param days
* the days to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the days subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the days subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1716,7 +1717,7 @@ final class ZonedDateTime(
* @param hours
* the hours to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the hours subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the hours subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1736,7 +1737,7 @@ final class ZonedDateTime(
* @param minutes
* the minutes to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the minutes subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the minutes subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1756,7 +1757,7 @@ final class ZonedDateTime(
* @param seconds
* the seconds to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the seconds subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the seconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1777,7 +1778,7 @@ final class ZonedDateTime(
* @param nanos
* the nanos to subtract, may be negative
* @return
- * a { @code ZonedDateTime} based on this date-time with the nanoseconds subtracted, not null
+ * a {@code ZonedDateTime} based on this date-time with the nanoseconds subtracted, not null
* @throws DateTimeException
* if the result exceeds the supported date range
*/
@@ -1818,9 +1819,9 @@ final class ZonedDateTime(
* This calculates the period between two date-times in terms of a single unit. The start and end
* points are {@code this} and the specified date-time. The result will be negative if the end is
* before the start. For example, the period in days between two date-times can be calculated
- * using {@code startDateTime.until(endDateTime, DAYS)}.
+ * using {@code startDateTime.until(endDateTime, DAYS)} .
*
- * The {@code Temporal} passed to this method must be a {@code ZonedDateTime}. If the time-zone
+ * The {@code Temporal} passed to this method must be a {@code ZonedDateTime} . If the time-zone
* differs between the two zoned date-times, the specified end date-time is normalized to have the
* same zone as this date-time.
*
@@ -1828,17 +1829,17 @@ final class ZonedDateTime(
* two date-times. For example, the period in months between 2012-06-15T00:00Z and
* 2012-08-14T23:59Z will only be one month as it is one minute short of two months.
*
- * This method operates in association with {@link TemporalUnit#between}. The result of this
+ * This method operates in association with {@link TemporalUnit#between} . The result of this
* method is a {@code long} representing the amount of the specified unit. By contrast, the result
* of {@code between} is an object that can be used directly in addition/subtraction: long
* period = start.until(end, MONTHS); // this method dateTime.plus(MONTHS.between(start, end)); //
* use in plus/minus
*
- * The calculation is implemented in this method for {@link ChronoUnit}. The units {@code NANOS},
- * {@code MICROS}, {@code MILLIS}, {@code SECONDS}, {@code MINUTES}, {@code HOURS} and {@code
- * HALF_DAYS}, {@code DAYS}, {@code WEEKS}, {@code MONTHS}, {@code YEARS}, {@code DECADES}, {@code
- * CENTURIES}, {@code MILLENNIA} and {@code ERAS} are supported. Other {@code ChronoUnit} values
- * will throw an exception.
+ * The calculation is implemented in this method for {@link ChronoUnit} . The units {@code NANOS}
+ * , {@code MICROS} , {@code MILLIS} , {@code SECONDS} , {@code MINUTES} , {@code HOURS} and
+ * {@code HALF_DAYS}, {@code DAYS} , {@code WEEKS} , {@code MONTHS} , {@code YEARS} ,
+ * {@code DECADES} , {@code CENTURIES}, {@code MILLENNIA} and {@code ERAS} are supported. Other
+ * {@code ChronoUnit} values will throw an exception.
*
* The calculation for date and time units differ.
*
@@ -1851,14 +1852,14 @@ final class ZonedDateTime(
* period from noon on day 1 to noon the following day in hours may be 23, 24 or 25 hours (or some
* other amount) depending on whether there was a daylight savings change or not.
*
- * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking
- * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and
- * the input temporal as the second argument.
+ * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by
+ * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first
+ * argument and the input temporal as the second argument.
*
* This instance is immutable and unaffected by this method call.
*
* @param endExclusive
- * the end date-time, which is converted to a { @code ZonedDateTime}, not null
+ * the end date-time, which is converted to a {@code ZonedDateTime} , not null
* @param unit
* the unit to measure the period in, not null
* @return
@@ -1912,7 +1913,7 @@ final class ZonedDateTime(
override def toLocalTime: LocalTime = dateTime.toLocalTime
/**
- * Converts this date-time to an {@code OffsetDateTime}.
+ * Converts this date-time to an {@code OffsetDateTime} .
*
* This creates an offset date-time using the local date-time and offset. The zone ID is ignored.
*
@@ -1949,10 +1950,10 @@ final class ZonedDateTime(
dateTime.hashCode ^ offset.hashCode ^ Integer.rotateLeft(zone.hashCode, 3)
/**
- * Outputs this date-time as a {@code String}, such as {@code
+ * Outputs this date-time as a {@code String} , such as {@code
* 2007-12-03T10:15:30+01:00[Europe/Paris]}.
*
- * The format consists of the {@code LocalDateTime} followed by the {@code ZoneOffset}. If the
+ * The format consists of the {@code LocalDateTime} followed by the {@code ZoneOffset} . If the
* {@code ZoneId} is not the same as the offset, then the ID is output. The output is compatible
* with ISO-8601 if the offset and ID are the same.
*
diff --git a/core/shared/src/main/scala/org/threeten/bp/chrono/AbstractChronology.scala b/core/shared/src/main/scala/org/threeten/bp/chrono/AbstractChronology.scala
index c3ce9a08b..8eb8afcd7 100644
--- a/core/shared/src/main/scala/org/threeten/bp/chrono/AbstractChronology.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/chrono/AbstractChronology.scala
@@ -32,7 +32,7 @@
package org.threeten.bp.chrono
/**
- * An abstract implementation of {@code Chronology}.
+ * An abstract implementation of {@code Chronology} .
*
* Specification for implementors
This class must be implemented with care to ensure other
* classes operate correctly. All implementations that can be instantiated must be final, immutable
diff --git a/core/shared/src/main/scala/org/threeten/bp/chrono/ChronoLocalDate.scala b/core/shared/src/main/scala/org/threeten/bp/chrono/ChronoLocalDate.scala
index 897d6880f..58200dcb9 100644
--- a/core/shared/src/main/scala/org/threeten/bp/chrono/ChronoLocalDate.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/chrono/ChronoLocalDate.scala
@@ -86,7 +86,7 @@ object ChronoLocalDate {
*
* This obtains a local date based on the specified temporal. A {@code TemporalAccessor}
* represents an arbitrary set of date and time information, which this factory converts to an
- * instance of {@code ChronoLocalDate}.
+ * instance of {@code ChronoLocalDate} .
*
* The conversion extracts and combines the chronology and the date from the temporal object. The
* behavior is equivalent to using {@link Chronology#date(TemporalAccessor)} with the extracted
@@ -94,14 +94,14 @@ object ChronoLocalDate {
* fields that are equivalent to the relevant objects.
*
* This method matches the signature of the functional interface {@link TemporalQuery} allowing it
- * to be used as a query via method reference, {@code ChronoLocalDate::from}.
+ * to be used as a query via method reference, {@code ChronoLocalDate::from} .
*
* @param temporal
* the temporal object to convert, not null
* @return
* the date, not null
* @throws DateTimeException
- * if unable to convert to a { @code ChronoLocalDate}
+ * if unable to convert to a {@code ChronoLocalDate}
* @see
* Chronology#date(TemporalAccessor)
*/
@@ -122,12 +122,12 @@ object ChronoLocalDate {
* A date without time-of-day or time-zone in an arbitrary chronology, intended for advanced
* globalization use cases.
*
- * Most applications should declare method signatures, fields and variables as {@link LocalDate},
- * not this interface.
+ * Most applications should declare method signatures, fields and variables as {@link LocalDate}
+ * , not this interface.
*
* A {@code ChronoLocalDate} is the abstract representation of a date where the {@code Chronology
* chronology}, or calendar system, is pluggable. The date is defined in terms of fields expressed
- * by {@link TemporalField}, where most common implementations are defined in {@link ChronoField}.
+ * by {@link TemporalField} , where most common implementations are defined in {@link ChronoField} .
* The chronology defines how the calendar system operates and the meaning of the standard fields.
*
* When to use this interface
The design of the API encourages the use of {@code LocalDate}
@@ -144,12 +144,12 @@ object ChronoLocalDate {
* To emphasize the point, declaring a method signature, field or variable as this interface type
* can initially seem like the sensible way to globalize an application, however it is usually the
* wrong approach. As such, it should be considered an application-wide architectural decision to
- * choose to use this interface as opposed to {@code LocalDate}.
+ * choose to use this interface as opposed to {@code LocalDate} .
*
* Architectural issues to consider
These are some of the points that must be considered
* before using this interface throughout an application.
*
- * 1) Applications using this interface, as opposed to using just {@code LocalDate}, face a
+ * 1) Applications using this interface, as opposed to using just {@code LocalDate} , face a
* significantly higher probability of bugs. This is because the calendar system in use is not known
* at development time. A key cause of bugs is where the developer applies assumptions from their
* day-to-day knowledge of the ISO calendar system to code that is intended to deal with any
@@ -220,7 +220,7 @@ object ChronoLocalDate {
*
* Using LocalDate instead
The primary alternative to using this interface throughout your
* application is as follows.
Adding New Calendars
The set of available chronologies can be extended * by applications. Adding a new calendar system requires the writing of an implementation of {@code - * Chronology}, {@code ChronoLocalDate} and {@code Era}. The majority of the logic specific to the - * calendar system will be in {@code ChronoLocalDate}. The {@code Chronology} subclass acts as a + * Chronology}, {@code ChronoLocalDate} and {@code Era} . The majority of the logic specific to the + * calendar system will be in {@code ChronoLocalDate} . The {@code Chronology} subclass acts as a * factory. * * To permit the discovery of additional chronologies, the {@link java.util.ServiceLoader @@ -290,7 +291,7 @@ trait Chronology extends Ordered[Chronology] { * @param temporal * a date-time to cast, not null * @return - * the date-time checked and cast to { @code ChronoLocalDate}, not null + * the date-time checked and cast to {@code ChronoLocalDate} , not null * @throws ClassCastException * if the date-time cannot be cast to ChronoLocalDate or the chronology is not equal this Chrono */ @@ -309,7 +310,7 @@ trait Chronology extends Ordered[Chronology] { * @param temporal * a date-time to cast, not null * @return - * the date-time checked and cast to { @code ChronoLocalDateTime}, not null + * the date-time checked and cast to {@code ChronoLocalDateTime} , not null * @throws ClassCastException * if the date-time cannot be cast to ChronoLocalDateTimeImpl or the chronology is not equal * this Chrono @@ -331,7 +332,7 @@ trait Chronology extends Ordered[Chronology] { * @param temporal * a date-time to cast, not null * @return - * the date-time checked and cast to { @code ChronoZonedDateTimeImpl}, not null + * the date-time checked and cast to {@code ChronoZonedDateTimeImpl} , not null * @throws ClassCastException * if the date-time cannot be cast to ChronoZonedDateTimeImpl or the chronology is not equal * this Chrono @@ -350,8 +351,8 @@ trait Chronology extends Ordered[Chronology] { /** * Gets the ID of the chronology. * - * The ID uniquely identifies the {@code Chronology}. It can be used to lookup the {@code - * Chronology} using {@link #of(String)}. + * The ID uniquely identifies the {@code Chronology} . It can be used to lookup the {@code + * Chronology} using {@link #of(String)} . * * @return * the chronology ID, not null @@ -392,7 +393,7 @@ trait Chronology extends Ordered[Chronology] { * @throws DateTimeException * if unable to create the date * @throws ClassCastException - * if the { @code era} is not of the correct type for the chronology + * if the {@code era} is not of the correct type for the chronology */ def date(era: Era, yearOfEra: Int, month: Int, dayOfMonth: Int): ChronoLocalDate = date(prolepticYear(era, yearOfEra), month, dayOfMonth) @@ -428,7 +429,7 @@ trait Chronology extends Ordered[Chronology] { * @throws DateTimeException * if unable to create the date * @throws ClassCastException - * if the { @code era} is not of the correct type for the chronology + * if the {@code era} is not of the correct type for the chronology */ def dateYearDay(era: Era, yearOfEra: Int, dayOfYear: Int): ChronoLocalDate = dateYearDay(prolepticYear(era, yearOfEra), dayOfYear) @@ -465,7 +466,7 @@ trait Chronology extends Ordered[Chronology] { /** * Obtains a local date in this chronology from another temporal object. * - * This creates a date in this chronology based on the specified {@code TemporalAccessor}. + * This creates a date in this chronology based on the specified {@code TemporalAccessor} . * * The standard mechanism for conversion between date types is the {@link ChronoField#EPOCH_DAY * local epoch-day} field. @@ -489,7 +490,7 @@ trait Chronology extends Ordered[Chronology] { * Using this method will prevent the ability to use an alternate clock for testing because the * clock is hard-coded. * - * This implementation uses {@link #dateNow(Clock)}. + * This implementation uses {@link #dateNow(Clock)} . * * @return * the current local date using the system clock and default time-zone, not null @@ -522,7 +523,7 @@ trait Chronology extends Ordered[Chronology] { * * This will query the specified clock to obtain the current date - today. Using this method * allows the use of an alternate clock for testing. The alternate clock may be introduced using - * {@link Clock dependency injection}. + * {@link Clock dependency injection} . * * @param clock * the clock to use, not null @@ -539,7 +540,7 @@ trait Chronology extends Ordered[Chronology] { /** * Obtains a local date-time in this chronology from another temporal object. * - * This creates a date-time in this chronology based on the specified {@code TemporalAccessor}. + * This creates a date-time in this chronology based on the specified {@code TemporalAccessor} . * * The date of the date-time should be equivalent to that obtained by calling {@link * #date(TemporalAccessor)}. The standard mechanism for conversion between time types is the @@ -567,10 +568,10 @@ trait Chronology extends Ordered[Chronology] { /** * Obtains a zoned date-time in this chronology from another temporal object. * - * This creates a date-time in this chronology based on the specified {@code TemporalAccessor}. + * This creates a date-time in this chronology based on the specified {@code TemporalAccessor} . * - * This should obtain a {@code ZoneId} using {@link ZoneId#from(TemporalAccessor)}. The date-time - * should be obtained by obtaining an {@code Instant}. If that fails, the local date-time should + * This should obtain a {@code ZoneId} using {@link ZoneId#from(TemporalAccessor)} . The date-time + * should be obtained by obtaining an {@code Instant} . If that fails, the local date-time should * be used. * * @param temporal @@ -604,7 +605,7 @@ trait Chronology extends Ordered[Chronology] { } /** - * Obtains a zoned date-time in this chronology from an {@code Instant}. + * Obtains a zoned date-time in this chronology from an {@code Instant} . * * This creates a zoned date-time with the same instant as that specified. * @@ -629,9 +630,9 @@ trait Chronology extends Ordered[Chronology] { * * The default implementation returns an implementation class suitable for most calendar systems. * It is based solely on the three units. Normalization, addition and subtraction derive the - * number of months in a year from the {@link #range(ChronoField)}. If the number of months within - * a year is fixed, then the calculation approach for addition, subtraction and normalization is - * slightly different. + * number of months in a year from the {@link #range(ChronoField)} . If the number of months + * within a year is fixed, then the calculation approach for addition, subtraction and + * normalization is slightly different. * * If implementing an unusual calendar system that is not based on years, months and days, or * where you want direct control, then the {@code ChronoPeriod} interface must be directly @@ -681,7 +682,7 @@ trait Chronology extends Ordered[Chronology] { * @throws DateTimeException * if unable to convert * @throws ClassCastException - * if the { @code era} is not of the correct type for the chronology + * if the {@code era} is not of the correct type for the chronology */ def prolepticYear(era: Era, yearOfEra: Int): Int @@ -823,7 +824,7 @@ trait Chronology extends Ordered[Chronology] { * Compares this chronology to another chronology. * * The comparison order first by the chronology ID string, then by any additional information - * specific to the subclass. It is "consistent with equals", as defined by {@link Comparable}. + * specific to the subclass. It is "consistent with equals", as defined by {@link Comparable} . * * The default implementation compares the chronology ID. Subclasses must compare any additional * state that they store. @@ -840,7 +841,7 @@ trait Chronology extends Ordered[Chronology] { * * The comparison is based on the entire state of the object. * - * The default implementation checks the type and calls {@link #compareTo(Chronology)}. + * The default implementation checks the type and calls {@link #compareTo(Chronology)} . * * @param obj * the object to check, null returns false @@ -865,7 +866,7 @@ trait Chronology extends Ordered[Chronology] { override def hashCode: Int = getClass.hashCode ^ getId.hashCode /** - * Outputs this chronology as a {@code String}, using the ID. + * Outputs this chronology as a {@code String} , using the ID. * * @return * a string representation of this chronology, not null diff --git a/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahChronology.scala b/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahChronology.scala index b89a806bd..6aa177e0a 100644 --- a/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahChronology.scala +++ b/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahChronology.scala @@ -138,8 +138,8 @@ final class HijrahChronology private () extends Chronology with Serializable { /** * Gets the ID of the chronology - 'Hijrah-umalqura'. * - * The ID uniquely identifies the {@code Chronology}. It can be used to lookup the {@code - * Chronology} using {@link #of(String)}. + * The ID uniquely identifies the {@code Chronology} . It can be used to lookup the {@code + * Chronology} using {@link #of(String)} . * * @return * the chronology ID - 'Hijrah-umalqura' diff --git a/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahDate.scala b/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahDate.scala index 5a882f5bd..2954aa62b 100644 --- a/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahDate.scala +++ b/core/shared/src/main/scala/org/threeten/bp/chrono/HijrahDate.scala @@ -89,9 +89,9 @@ object HijrahDate { Array(30, 29, 30, 29, 30, 29, 30, 29, 30, 29, 30, 30) /** - *Greatest Least Field name Minimum Minimum Maximum Maximum - * ---------- ------- ------- ------- ------- ERA 0 0 1 1 YEAR_OF_ERA 1 1 9999 9999 MONTH_OF_YEAR - * 1 1 12 12 DAY_OF_MONTH 1 1 29 30 DAY_OF_YEAR 1 1 354 355+ *
Greatest Least Field name Minimum Minimum Maximum Maximum ---------- ------- ------- + * ------- ------- ERA 0 0 1 1 YEAR_OF_ERA 1 1 9999 9999 MONTH_OF_YEAR 1 1 12 12 DAY_OF_MONTH 1 1 + * 29 30 DAY_OF_YEAR 1 1 354 355* * Minimum values. */ @@ -293,7 +293,7 @@ object HijrahDate { * * This will query the specified clock to obtain the current date - today. Using this method * allows the use of an alternate clock for testing. The alternate clock may be introduced using - * {@linkplain Clock dependency injection}. + * {@linkplain Clock dependency injection} . * * @param clock * the clock to use, not null @@ -407,20 +407,20 @@ object HijrahDate { * * This obtains a date in the Hijrah calendar system based on the specified temporal. A {@code * TemporalAccessor} represents an arbitrary set of date and time information, which this factory - * converts to an instance of {@code HijrahDate}. + * converts to an instance of {@code HijrahDate} . * * The conversion typically uses the {@link ChronoField#EPOCH_DAY EPOCH_DAY} field, which is * standardized across calendar systems. * * This method matches the signature of the functional interface {@link TemporalQuery} allowing it - * to be used as a query via method reference, {@code HijrahDate::from}. + * to be used as a query via method reference, {@code HijrahDate::from} . * * @param temporal * the temporal object to convert, not null * @return * the date in Hijrah calendar system, not null * @throws DateTimeException - * if unable to convert to a { @code HijrahDate} + * if unable to convert to a {@code HijrahDate} */ def from(temporal: TemporalAccessor): HijrahDate = HijrahChronology.INSTANCE.date(temporal) @@ -1144,7 +1144,7 @@ object HijrahDate { /** * A date in the Hijrah calendar system. * - * This implements {@code ChronoLocalDate} for the {@link HijrahChronology Hijrah calendar}. + * This implements {@code ChronoLocalDate} for the {@link HijrahChronology Hijrah calendar} . * * The Hijrah calendar has a different total of days in a year than Gregorian calendar, and a month * is based on the period of a complete revolution of the moon around the earth (as between diff --git a/core/shared/src/main/scala/org/threeten/bp/chrono/IsoChronology.scala b/core/shared/src/main/scala/org/threeten/bp/chrono/IsoChronology.scala index 1d3fc11f2..bbc4b77af 100644 --- a/core/shared/src/main/scala/org/threeten/bp/chrono/IsoChronology.scala +++ b/core/shared/src/main/scala/org/threeten/bp/chrono/IsoChronology.scala @@ -107,8 +107,8 @@ final class IsoChronology private () extends Chronology with Serializable { /** * Gets the ID of the chronology - 'ISO'. * - * The ID uniquely identifies the {@code Chronology}. It can be used to lookup the {@code - * Chronology} using {@link #of(String)}. + * The ID uniquely identifies the {@code Chronology} . It can be used to lookup the {@code + * Chronology} using {@link #of(String)} . * * @return * the chronology ID - 'ISO' @@ -154,7 +154,7 @@ final class IsoChronology private () extends Chronology with Serializable { /** * Obtains an ISO local date from the proleptic-year, month-of-year and day-of-month fields. * - * This is equivalent to {@link LocalDate#of(int, int, int)}. + * This is equivalent to {@link LocalDate#of(int, int, int)} . * * @param prolepticYear * the ISO proleptic-year @@ -190,7 +190,7 @@ final class IsoChronology private () extends Chronology with Serializable { /** * Obtains an ISO local date from the proleptic-year and day-of-year fields. * - * This is equivalent to {@link LocalDate#ofYearDay(int, int)}. + * This is equivalent to {@link LocalDate#ofYearDay(int, int)} . * * @param prolepticYear * the ISO proleptic-year @@ -209,7 +209,7 @@ final class IsoChronology private () extends Chronology with Serializable { /** * Obtains an ISO local date from another date-time object. * - * This is equivalent to {@link LocalDate#from(TemporalAccessor)}. + * This is equivalent to {@link LocalDate#from(TemporalAccessor)} . * * @param temporal * the date-time object to convert, not null @@ -223,7 +223,7 @@ final class IsoChronology private () extends Chronology with Serializable { /** * Obtains an ISO local date-time from another date-time object. * - * This is equivalent to {@link LocalDateTime#from(TemporalAccessor)}. + * This is equivalent to {@link LocalDateTime#from(TemporalAccessor)} . * * @param temporal * the date-time object to convert, not null @@ -238,7 +238,7 @@ final class IsoChronology private () extends Chronology with Serializable { /** * Obtains an ISO zoned date-time from another date-time object. * - * This is equivalent to {@link ZonedDateTime#from(TemporalAccessor)}. + * This is equivalent to {@link ZonedDateTime#from(TemporalAccessor)} . * * @param temporal * the date-time object to convert, not null @@ -253,7 +253,7 @@ final class IsoChronology private () extends Chronology with Serializable { /** * Obtains an ISO zoned date-time from an instant. * - * This is equivalent to {@link ZonedDateTime#ofInstant(Instant, ZoneId)}. + * This is equivalent to {@link ZonedDateTime#ofInstant(Instant, ZoneId)} . * * @param instant * the instant to convert, not null @@ -304,7 +304,7 @@ final class IsoChronology private () extends Chronology with Serializable { * * This will query the specified clock to obtain the current date - today. Using this method * allows the use of an alternate clock for testing. The alternate clock may be introduced using - * {@link Clock dependency injection}. + * {@link Clock dependency injection} . * * @param clock * the clock to use, not null diff --git a/core/shared/src/main/scala/org/threeten/bp/chrono/MinguoChronology.scala b/core/shared/src/main/scala/org/threeten/bp/chrono/MinguoChronology.scala index e41849f7e..8b61592ee 100644 --- a/core/shared/src/main/scala/org/threeten/bp/chrono/MinguoChronology.scala +++ b/core/shared/src/main/scala/org/threeten/bp/chrono/MinguoChronology.scala @@ -77,7 +77,7 @@ object MinguoChronology { * * This chronology defines the rules of the Minguo calendar system. This calendar system is * primarily used in the Republic of China, often known as Taiwan. Dates are aligned such that - * {@code 0001-01-01 (Minguo)} is {@code 1912-01-01 (ISO)}. + * {@code 0001-01-01 (Minguo)} is {@code 1912-01-01 (ISO)} . * * The fields are defined as follows:
+ * outside the valid range for the field
* *
+ * dash
*/ lazy val ISO_LOCAL_DATE: DateTimeFormatter = new DateTimeFormatterBuilder() .appendValue(YEAR, 4, 10, SignStyle.EXCEEDS_PAD) @@ -109,7 +110,7 @@ object DateTimeFormatter { * available to print/parse then the format is complete.
As this formatter has an optional - * element, it may be necessary to parse using {@link DateTimeFormatter#parseBest}. + * element, it may be necessary to parse using {@link DateTimeFormatter#parseBest} . */ lazy val ISO_DATE: DateTimeFormatter = new DateTimeFormatterBuilder().parseCaseInsensitive .append(ISO_LOCAL_DATE) @@ -125,12 +126,12 @@ object DateTimeFormatter { * This returns an immutable formatter capable of printing and parsing the ISO-8601 extended local * time format. The format consists of:
*/ lazy val ISO_LOCAL_TIME: DateTimeFormatter = new DateTimeFormatterBuilder() @@ -198,7 +199,7 @@ object DateTimeFormatter { * * This returns an immutable formatter capable of printing and parsing the ISO-8601 extended * offset date-time format. The format consists of:
*/ @@ -243,7 +244,7 @@ object DateTimeFormatter { * ZoneOffset} then the format is complete.
As this formatter has an optional element, it may be - * necessary to parse using {@link DateTimeFormatter#parseBest}. + * necessary to parse using {@link DateTimeFormatter#parseBest} . */ lazy val ISO_DATE_TIME: DateTimeFormatter = new DateTimeFormatterBuilder() .append(ISO_LOCAL_DATE_TIME) @@ -265,12 +266,12 @@ object DateTimeFormatter { * ordinal date format. The format consists of:
As this formatter has an optional element, it may be necessary to - * parse using {@link DateTimeFormatter#parseBest}. + * parse using {@link DateTimeFormatter#parseBest} . */ lazy val ISO_ORDINAL_DATE: DateTimeFormatter = new DateTimeFormatterBuilder().parseCaseInsensitive .appendValue(YEAR, 4, 10, SignStyle.EXCEEDS_PAD) @@ -290,13 +291,13 @@ object DateTimeFormatter { * IsoFields#WEEK_BASED_YEAR week-based-year}. Years in the range 0000 to 9999 will be pre-padded * by zero to ensure four digits. Years outside that range will have a prefixed positive or * negative symbol.
As this formatter has an optional element, it - * may be necessary to parse using {@link DateTimeFormatter#parseBest}. + * may be necessary to parse using {@link DateTimeFormatter#parseBest} . */ lazy val ISO_WEEK_DATE: DateTimeFormatter = new DateTimeFormatterBuilder().parseCaseInsensitive .appendValue(IsoFields.WEEK_BASED_YEAR, 4, 10, SignStyle.EXCEEDS_PAD) @@ -324,7 +325,7 @@ object DateTimeFormatter { * point in time and internally stores a value in nanoseconds from a fixed epoch of 1970-01-01Z. * As such, an {@code Instant} cannot be formatted as a date or time without providing some form * of time-zone. This formatter allows the {@code Instant} to be formatted, by providing a - * suitable conversion using {@code ZoneOffset.UTC}. + * suitable conversion using {@code ZoneOffset.UTC} . * * The format consists of:
As this formatter has an optional element, it may be - * necessary to parse using {@link DateTimeFormatter#parseBest}. + * necessary to parse using {@link DateTimeFormatter#parseBest} . */ lazy val BASIC_ISO_DATE: DateTimeFormatter = new DateTimeFormatterBuilder().parseCaseInsensitive .appendValue(YEAR, 4) @@ -370,13 +371,13 @@ object DateTimeFormatter { * * The format consists of:
Symbol Meaning Presentation Examples - * ------ ------- ------------ ------- G era number/text 1; 01; AD; Anno Domini y year year 2004; - * 04 D day-of-year number 189 M month-of-year number/text 7; 07; Jul; July; J d day-of-month - * number 10 + * letters are defined:Symbol Meaning Presentation Examples ------ ------- ------------ + * ------- G era number/text 1; 01; AD; Anno Domini y year year 2004; 04 D day-of-year number 189 + * M month-of-year number/text 7; 07; Jul; July; J d day-of-month number 10 * * Q quarter-of-year number/text 3; 03; Q3 Y week-based-year year 1996; 96 w week-of-year number * 27 W week-of-month number 27 e localized day-of-week number 2; Tue; Tuesday; T E day-of-week @@ -469,9 +469,9 @@ object DateTimeFormatter { * The count of pattern letters determine the format. * * Text: The text style is determined based on the number of pattern letters used. Less - * than 4 pattern letters will use the {@link TextStyle#SHORT short form}. Exactly 4 pattern - * letters will use the {@link TextStyle#FULL full form}. Exactly 5 pattern letters will use the - * {@link TextStyle#NARROW narrow form}. + * than 4 pattern letters will use the {@link TextStyle#SHORT short form} . Exactly 4 pattern + * letters will use the {@link TextStyle#FULL full form} . Exactly 5 pattern letters will use the + * {@link TextStyle#NARROW narrow form} . * * Number: If the count of letters is one, then the value is printed using the minimum * number of digits and without padding as per {@link @@ -494,7 +494,7 @@ object DateTimeFormatter { * reduced} two digit form is used. For printing, this outputs the rightmost two digits. For * parsing, this will parse using the base value of 2000, resulting in a year within the range * 2000 to 2099 inclusive. If the count of letters is less than four (but not two), then the sign - * is only output for negative years as per {@link SignStyle#NORMAL}. Otherwise, the sign is + * is only output for negative years as per {@link SignStyle#NORMAL} . Otherwise, the sign is * output if the pad width is exceeded, as per {@link SignStyle#EXCEEDS_PAD} * * ZoneId: This outputs the time-zone ID, such as 'Europe/Paris'. If the count of letters @@ -503,7 +503,7 @@ object DateTimeFormatter { * * Zone names: This outputs the display name of the time-zone ID. If the count of letters * is one, two or three, then the short name is output. If the count of letters is four, then the - * full name is output. Five or more letters throws {@code IllegalArgumentException}. + * full name is output. Five or more letters throws {@code IllegalArgumentException} . * * Offset X and x: This formats the offset based on the number of pattern letters. One * letter outputs just the hour', such as '+01', unless the minute is non-zero in which case the @@ -511,21 +511,21 @@ object DateTimeFormatter { * colon, such as '+0130'. Three letters outputs the hour and minute, with a colon, such as * '+01:30'. Four letters outputs the hour and minute and optional second, without a colon, such * as '+013015'. Five letters outputs the hour and minute and optional second, with a colon, such - * as '+01:30:15'. Six or more letters throws {@code IllegalArgumentException}. Pattern letter 'X' - * (upper case) will output 'Z' when the offset to be output would be zero, whereas pattern letter - * 'x' (lower case) will output '+00', '+0000', or '+00:00'. + * as '+01:30:15'. Six or more letters throws {@code IllegalArgumentException} . Pattern letter + * 'X' (upper case) will output 'Z' when the offset to be output would be zero, whereas pattern + * letter 'x' (lower case) will output '+00', '+0000', or '+00:00'. * * Offset Z: This formats the offset based on the number of pattern letters. One, two or * three letters outputs the hour and minute, without a colon, such as '+0130'. Four or more - * letters throws {@code IllegalArgumentException}. The output will be '+0000' when the offset is + * letters throws {@code IllegalArgumentException} . The output will be '+0000' when the offset is * zero. * * Optional section: The optional section markers work exactly like calling {@link - * DateTimeFormatterBuilder#optionalStart()} and {@link DateTimeFormatterBuilder#optionalEnd()}. + * DateTimeFormatterBuilder#optionalStart()} and {@link DateTimeFormatterBuilder#optionalEnd()} . * * Pad modifier: Modifies the pattern that immediately follows to be padded with spaces. * The pad width is determined by the number of pattern letters. This is the same as calling - * {@link DateTimeFormatterBuilder#padNext(int)}. + * {@link DateTimeFormatterBuilder#padNext(int)} . * * For example, 'ppH' outputs the hour-of-day padded on the left with spaces to a width of 2. * @@ -578,7 +578,7 @@ object DateTimeFormatter { * locale. * * The locale is determined from the formatter. The formatter returned directly by this method - * will use the {@link Locale#getDefault() default locale}. The locale can be controlled using + * will use the {@link Locale#getDefault() default locale} . The locale can be controlled using * {@link DateTimeFormatter#withLocale(Locale) withLocale(Locale)} on the result of this method. * * Note that the localized pattern is looked up lazily. This {@code DateTimeFormatter} holds the @@ -604,7 +604,7 @@ object DateTimeFormatter { * locale. * * The locale is determined from the formatter. The formatter returned directly by this method - * will use the {@link Locale#getDefault() default locale}. The locale can be controlled using + * will use the {@link Locale#getDefault() default locale} . The locale can be controlled using * {@link DateTimeFormatter#withLocale(Locale) withLocale(Locale)} on the result of this method. * * Note that the localized pattern is looked up lazily. This {@code DateTimeFormatter} holds the @@ -630,7 +630,7 @@ object DateTimeFormatter { * varies by locale. * * The locale is determined from the formatter. The formatter returned directly by this method - * will use the {@link Locale#getDefault() default locale}. The locale can be controlled using + * will use the {@link Locale#getDefault() default locale} . The locale can be controlled using * {@link DateTimeFormatter#withLocale(Locale) withLocale(Locale)} on the result of this method. * * Note that the localized pattern is looked up lazily. This {@code DateTimeFormatter} holds the @@ -656,7 +656,7 @@ object DateTimeFormatter { * varies by locale. * * The locale is determined from the formatter. The formatter returned directly by this method - * will use the {@link Locale#getDefault() default locale}. The locale can be controlled using + * will use the {@link Locale#getDefault() default locale} . The locale can be controlled using * {@link DateTimeFormatter#withLocale(Locale) withLocale(Locale)} on the result of this method. * * Note that the localized pattern is looked up lazily. This {@code DateTimeFormatter} holds the @@ -839,7 +839,7 @@ object DateTimeFormatter { * For more complex formatters, a {@link DateTimeFormatterBuilder builder} is provided. * * In most cases, it is not necessary to use this class directly when formatting. The main date-time - * classes provide two methods - one for formatting, {@code format(DateTimeFormatter formatter)}, + * classes provide two methods - one for formatting, {@code format(DateTimeFormatter formatter)} , * and one for parsing, For example:String text = date.format(formatter); LocalDate date = * LocalDate.parse(text, formatter);Some aspects of printing and parsing are dependent on * the locale. The locale can be changed using the {@link #withLocale(Locale)} method which returns @@ -973,7 +973,7 @@ final class DateTimeFormatter private[format] ( * When printing, if the {@code Temporal} object contains a date then it will be converted to a * date in the override chronology. Any time or zone will be retained unless overridden. The * converted result will behave in a manner equivalent to an implementation of {@code - * ChronoLocalDate},{@code ChronoLocalDateTime} or {@code ChronoZonedDateTime}. + * ChronoLocalDate},{@code ChronoLocalDateTime} or {@code ChronoZonedDateTime} . * * When parsing, the override chronology will be used to interpret the {@linkplain ChronoField * fields} into a date unless the formatter directly parses a valid chronology. @@ -1019,9 +1019,9 @@ final class DateTimeFormatter private[format] ( * * When printing, if the {@code Temporal} object contains an instant then it will be converted to * a zoned date-time using the override zone. If the input has a chronology then it will be - * retained unless overridden. If the input does not have a chronology, such as {@code Instant}, + * retained unless overridden. If the input does not have a chronology, such as {@code Instant} , * then the ISO chronology will be used. The converted result will behave in a manner equivalent - * to an implementation of {@code ChronoZonedDateTime}. + * to an implementation of {@code ChronoZonedDateTime} . * * When parsing, the override zone will be used to interpret the {@linkplain ChronoField fields} * into an instant unless the formatter directly parses a valid zone. @@ -1240,9 +1240,9 @@ final class DateTimeFormatter private[format] ( * * This formats the date-time to the specified destination. {@link Appendable} is a general * purpose interface that is implemented by all key character output classes including {@code - * StringBuffer}, {@code StringBuilder}, {@code PrintStream} and {@code Writer}. + * StringBuffer}, {@code StringBuilder} , {@code PrintStream} and {@code Writer} . * - * Although {@code Appendable} methods throw an {@code IOException}, this method does not. + * Although {@code Appendable} methods throw an {@code IOException} , this method does not. * Instead, any {@code IOException} is wrapped in a runtime exception. * * @param temporal @@ -1276,7 +1276,7 @@ final class DateTimeFormatter private[format] ( * Fully parses the text producing a temporal object. * * This parses the entire text producing a temporal object. It is typically more useful to use - * {@link #parse(CharSequence, TemporalQuery)}. The result of this method is {@code + * {@link #parse(CharSequence, TemporalQuery)} . The result of this method is {@code * TemporalAccessor} which has been resolved, applying basic validation checks to help ensure a * valid date-time. * @@ -1306,13 +1306,13 @@ final class DateTimeFormatter private[format] ( * finish at the end. The result of this method is {@code TemporalAccessor} which has been * resolved, applying basic validation checks to help ensure a valid date-time. * - * The text will be parsed from the specified start {@code ParsePosition}. The entire length of + * The text will be parsed from the specified start {@code ParsePosition} . The entire length of * the text does not have to be parsed, the {@code ParsePosition} will be updated with the index * at the end of parsing. * * The operation of this method is slightly different to similar methods using {@code - * ParsePosition} on {@code java.text.Format}. That class will return errors using the error index - * on the {@code ParsePosition}. By contrast, this method will throw a {@link + * ParsePosition} on {@code java.text.Format} . That class will return errors using the error + * index on the {@code ParsePosition} . By contrast, this method will throw a {@link * DateTimeParseException} if an error occurs, with the exception containing the error index. This * change in behavior is necessary due to the increased complexity of parsing and resolving * dates/times in this API. @@ -1378,10 +1378,10 @@ final class DateTimeFormatter private[format] ( * Fully parses the text producing an object of one of the specified types. * * This parse method is convenient for use when the parser can handle optional elements. For - * example, a pattern of 'yyyy[-MM[-dd]]' can be fully parsed to a {@code LocalDate}, or partially - * parsed to a {@code YearMonth} or a {@code Year}. The types must be specified in order, starting - * from the best matching full-parse option and ending with the worst matching minimal parse - * option. + * example, a pattern of 'yyyy[-MM[-dd]]' can be fully parsed to a {@code LocalDate} , or + * partially parsed to a {@code YearMonth} or a {@code Year} . The types must be specified in + * order, starting from the best matching full-parse option and ending with the worst matching + * minimal parse option. * * The result is associated with the first type that successfully parses. Normally, applications * will use {@code instanceof} to check the result. For example:TemporalAccessor dt = @@ -1392,7 +1392,7 @@ final class DateTimeFormatter private[format] ( * @param text * the text to parse, not null * @param types - * the types to attempt to parse to, which must implement { @code TemporalAccessor}, not null + * the types to attempt to parse to, which must implement {@code TemporalAccessor} , not null * @return * the parsed date-time, not null * @throws IllegalArgumentException @@ -1482,7 +1482,7 @@ final class DateTimeFormatter private[format] ( * * Parsing is implemented as a two-phase operation. First, the text is parsed using the layout * defined by the formatter, producing a {@code Map} of field to value, a {@code ZoneId} and a - * {@code Chronology}. Second, the parsed data is resolved, by validating, combining and + * {@code Chronology} . Second, the parsed data is resolved, by validating, combining and * simplifying the various fields into more useful ones. This method performs the parsing stage * but not the resolving stage. * @@ -1490,7 +1490,7 @@ final class DateTimeFormatter private[format] ( * input. Values are not validated, thus parsing a date string of '2012-00-65' would result in a * temporal with three fields - year of '2012', month of '0' and day-of-month of '65'. * - * The text will be parsed from the specified start {@code ParsePosition}. The entire length of + * The text will be parsed from the specified start {@code ParsePosition} . The entire length of * the text does not have to be parsed, the {@code ParsePosition} will be updated with the index * at the end of parsing. * @@ -1551,9 +1551,9 @@ final class DateTimeFormatter private[format] ( * Returns this formatter as a {@code java.text.Format} instance. * * The returned {@link Format} instance will print any {@link TemporalAccessor} and parses to a - * resolved {@link TemporalAccessor}. + * resolved {@link TemporalAccessor} . * - * Exceptions will follow the definitions of {@code Format}, see those methods for details about + * Exceptions will follow the definitions of {@code Format} , see those methods for details about * {@code IllegalArgumentException} during formatting and {@code ParseException} or null during * parsing. The format does not support attributing of the returned format string. * @@ -1567,9 +1567,9 @@ final class DateTimeFormatter private[format] ( * type. * * The returned {@link Format} instance will print any {@link TemporalAccessor} and parses to the - * type specified. The type must be one that is supported by {@link #parse}. + * type specified. The type must be one that is supported by {@link #parse} . * - * Exceptions will follow the definitions of {@code Format}, see those methods for details about + * Exceptions will follow the definitions of {@code Format} , see those methods for details about * {@code IllegalArgumentException} during formatting and {@code ParseException} or null during * parsing. The format does not support attributing of the returned format string. * diff --git a/core/shared/src/main/scala/org/threeten/bp/format/DateTimeFormatterBuilder.scala b/core/shared/src/main/scala/org/threeten/bp/format/DateTimeFormatterBuilder.scala index b5066dfe9..fabfcf89e 100644 --- a/core/shared/src/main/scala/org/threeten/bp/format/DateTimeFormatterBuilder.scala +++ b/core/shared/src/main/scala/org/threeten/bp/format/DateTimeFormatterBuilder.scala @@ -152,7 +152,7 @@ object DateTimeFormatterBuilder { * The basic elements of date-time can all be added:
Symbol Meaning Presentation Examples - * ------ ------- ------------ ------- G era number/text 1; 01; AD; Anno Domini y year year 2004; - * 04 D day-of-year number 189 M month-of-year number/text 7; 07; Jul; July; J d day-of-month - * number 10 + * following pattern letters are defined:Symbol Meaning Presentation Examples ------ + * ------- ------------ ------- G era number/text 1; 01; AD; Anno Domini y year year 2004; 04 D + * day-of-year number 189 M month-of-year number/text 7; 07; Jul; July; J d day-of-month number 10 * * Q quarter-of-year number/text 3; 03; Q3 Y week-based-year year 1996; 96 w week-of-year number * 27 W week-of-month number 27 e localized day-of-week number 2; Tue; Tuesday; T E day-of-week @@ -1264,13 +1264,13 @@ final class DateTimeFormatterBuilder private ( * The count of pattern letters determine the format. * * Text: The text style is determined based on the number of pattern letters used. Less - * than 4 pattern letters will use the {@link TextStyle#SHORT short form}. Exactly 4 pattern - * letters will use the {@link TextStyle#FULL full form}. Exactly 5 pattern letters will use the - * {@link TextStyle#NARROW narrow form}. + * than 4 pattern letters will use the {@link TextStyle#SHORT short form} . Exactly 4 pattern + * letters will use the {@link TextStyle#FULL full form} . Exactly 5 pattern letters will use the + * {@link TextStyle#NARROW narrow form} . * * Number: If the count of letters is one, then the value is printed using the minimum - * number of digits and without padding as per {@link #appendValue(TemporalField)}. Otherwise, the - * count of digits is used as the width of the output field as per {@link + * number of digits and without padding as per {@link #appendValue(TemporalField)} . Otherwise, + * the count of digits is used as the width of the output field as per {@link * #appendValue(TemporalField, int)}. * * Number/Text: If the count of pattern letters is 3 or greater, use the Text rules above. @@ -1288,7 +1288,7 @@ final class DateTimeFormatterBuilder private ( * is used. For printing, this outputs the rightmost two digits. For parsing, this will parse * using the base value of 2000, resulting in a year within the range 2000 to 2099 inclusive. If * the count of letters is less than four (but not two), then the sign is only output for negative - * years as per {@link SignStyle#NORMAL}. Otherwise, the sign is output if the pad width is + * years as per {@link SignStyle#NORMAL} . Otherwise, the sign is output if the pad width is * exceeded, as per {@link SignStyle#EXCEEDS_PAD} * * ZoneId: This outputs the time-zone ID, such as 'Europe/Paris'. If the count of letters @@ -1297,7 +1297,7 @@ final class DateTimeFormatterBuilder private ( * * Zone names: This outputs the display name of the time-zone ID. If the count of letters * is one, two or three, then the short name is output. If the count of letters is four, then the - * full name is output. Five or more letters throws {@code IllegalArgumentException}.+ * full name is output. Five or more letters throws {@code IllegalArgumentException} .* Pattern Equivalent builder methods z appendZoneText(TextStyle.SHORT) zz * appendZoneText(TextStyle.SHORT) zzz appendZoneText(TextStyle.SHORT) zzzz * appendZoneText(TextStyle.FULL)@@ -1308,27 +1308,27 @@ final class DateTimeFormatterBuilder private ( * colon, such as '+0130'. Three letters outputs the hour and minute, with a colon, such as * '+01:30'. Four letters outputs the hour and minute and optional second, without a colon, such * as '+013015'. Five letters outputs the hour and minute and optional second, with a colon, such - * as '+01:30:15'. Six or more letters throws {@code IllegalArgumentException}. Pattern letter 'X' - * (upper case) will output 'Z' when the offset to be output would be zero, whereas pattern letter - * 'x' (lower case) will output '+00', '+0000', or '+00:00'.Pattern Equivalent builder - * methods X appendOffset("+HHmm","Z") XX appendOffset("+HHMM","Z") XXX appendOffset("+HH:MM","Z") - * XXXX appendOffset("+HHMMss","Z") XXXXX appendOffset("+HH:MM:ss","Z") x - * appendOffset("+HHmm","+00") xx appendOffset("+HHMM","+0000") xxx + * as '+01:30:15'. Six or more letters throws {@code IllegalArgumentException} . Pattern letter + * 'X' (upper case) will output 'Z' when the offset to be output would be zero, whereas pattern + * letter 'x' (lower case) will output '+00', '+0000', or '+00:00'.Pattern Equivalent + * builder methods X appendOffset("+HHmm","Z") XX appendOffset("+HHMM","Z") XXX + * appendOffset("+HH:MM","Z") XXXX appendOffset("+HHMMss","Z") XXXXX appendOffset("+HH:MM:ss","Z") + * x appendOffset("+HHmm","+00") xx appendOffset("+HHMM","+0000") xxx * appendOffset("+HH:MM","+00:00") xxxx appendOffset("+HHMMss","+0000") xxxxx * appendOffset("+HH:MM:ss","+00:00")* * Offset Z: This formats the offset based on the number of pattern letters. One, two or * three letters outputs the hour and minute, without a colon, such as '+0130'. Four or more - * letters throws {@code IllegalArgumentException}. The output will be '+0000' when the offset is + * letters throws {@code IllegalArgumentException} . The output will be '+0000' when the offset is * zero.Pattern Equivalent builder methods Z appendOffset("+HHMM","+0000") ZZ * appendOffset("+HHMM","+0000") ZZZ appendOffset("+HHMM","+0000")* * Optional section: The optional section markers work exactly like calling {@link - * #optionalStart()} and {@link #optionalEnd()}. + * #optionalStart()} and {@link #optionalEnd()} . * * Pad modifier: Modifies the pattern that immediately follows to be padded with spaces. * The pad width is determined by the number of pattern letters. This is the same as calling - * {@link #padNext(int)}. + * {@link #padNext(int)} . * * For example, 'ppH' outputs the hour-of-day padded on the left with spaces to a width of 2. * @@ -1705,7 +1705,7 @@ final class DateTimeFormatterBuilder private ( * @return * this, for chaining, not null * @throws IllegalStateException - * if there was no previous call to { @code optionalStart} + * if there was no previous call to {@code optionalStart} */ def optionalEnd(): DateTimeFormatterBuilder = { if (active.parent == null) @@ -1759,7 +1759,7 @@ final class DateTimeFormatterBuilder private ( * #optionalEnd()} before creating the formatter. * * This builder can still be used after creating the formatter if desired, although the state may - * have been changed by calls to {@code optionalEnd}. + * have been changed by calls to {@code optionalEnd} . * * @return * the created formatter, not null @@ -1776,7 +1776,7 @@ final class DateTimeFormatterBuilder private ( * #optionalEnd()} before creating the formatter. * * This builder can still be used after creating the formatter if desired, although the state may - * have been changed by calls to {@code optionalEnd}. + * have been changed by calls to {@code optionalEnd} . * * @param locale * the locale to use for formatting, not null diff --git a/core/shared/src/main/scala/org/threeten/bp/format/SimpleDateTimeFormatStyleProvider.scala b/core/shared/src/main/scala/org/threeten/bp/format/SimpleDateTimeFormatStyleProvider.scala index 9c240e7e2..e50e2b175 100644 --- a/core/shared/src/main/scala/org/threeten/bp/format/SimpleDateTimeFormatStyleProvider.scala +++ b/core/shared/src/main/scala/org/threeten/bp/format/SimpleDateTimeFormatStyleProvider.scala @@ -48,7 +48,7 @@ private object SimpleDateTimeFormatStyleProvider { /** * The Service Provider Implementation to obtain date-time formatters for a style. * - * This implementation is based on extraction of data from a {@link SimpleDateFormat}. + * This implementation is based on extraction of data from a {@link SimpleDateFormat} . * *Specification for implementors
This class is immutable and thread-safe. */ diff --git a/core/shared/src/main/scala/org/threeten/bp/format/internal/DateTimePrinterParser.scala b/core/shared/src/main/scala/org/threeten/bp/format/internal/DateTimePrinterParser.scala index 7b5cf17c3..3823599c0 100644 --- a/core/shared/src/main/scala/org/threeten/bp/format/internal/DateTimePrinterParser.scala +++ b/core/shared/src/main/scala/org/threeten/bp/format/internal/DateTimePrinterParser.scala @@ -12,7 +12,7 @@ import java.lang.StringBuilder * Typically, each individual parser will just parse one field, such as the day-of-month, storing * the value in the context. Once the parse is complete, the caller will then convert the context to * a {@link DateTimeBuilder} to merge the parsed values to create the desired object, such as a - * {@code LocalDate}. + * {@code LocalDate} . * * The parse position will be updated during the parse. Parsing will start at the specified index * and the return value specifies the new parse position for the next parser. If an error occurs, diff --git a/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPDateTimeParseContext.scala b/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPDateTimeParseContext.scala index e4e1cd950..76c39a6d7 100644 --- a/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPDateTimeParseContext.scala +++ b/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPDateTimeParseContext.scala @@ -178,7 +178,7 @@ final class TTBPDateTimeParseContext( def setCaseSensitive(caseSensitive: Boolean): Unit = this.caseSensitive = caseSensitive /** - * Helper to compare two {@code CharSequence} instances. This uses {@link #isCaseSensitive()}. + * Helper to compare two {@code CharSequence} instances. This uses {@link #isCaseSensitive()} . * * @param cs1 * the first character sequence, not null @@ -228,7 +228,7 @@ final class TTBPDateTimeParseContext( } /** - * Helper to compare two {@code char}. This uses {@link #isCaseSensitive()}. + * Helper to compare two {@code char} . This uses {@link #isCaseSensitive()} . * * @param ch1 * the first character @@ -463,7 +463,7 @@ final class TTBPDateTimeParseContext( * * This method is typically used once parsing is complete to obtain the parsed data. Parsing * will typically result in separate fields, such as year, month and day. The returned builder - * can be used to combine the parsed data into meaningful objects such as {@code LocalDate}, + * can be used to combine the parsed data into meaningful objects such as {@code LocalDate} , * potentially applying complex processing to handle invalid parsed data. * * @return diff --git a/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPSimpleDateTimeTextProvider.scala b/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPSimpleDateTimeTextProvider.scala index ef645bee8..8578cc8bf 100644 --- a/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPSimpleDateTimeTextProvider.scala +++ b/core/shared/src/main/scala/org/threeten/bp/format/internal/TTBPSimpleDateTimeTextProvider.scala @@ -133,7 +133,7 @@ object TTBPSimpleDateTimeTextProvider { /** * The Service Provider Implementation to obtain date-time text for a field. * - * This implementation is based on extraction of data from a {@link DateFormatSymbols}. + * This implementation is based on extraction of data from a {@link DateFormatSymbols} . * *Specification for implementors
This class is immutable and thread-safe. */ diff --git a/core/shared/src/main/scala/org/threeten/bp/package.scala b/core/shared/src/main/scala/org/threeten/bp/package.scala index d5fd8f3ce..1c8d3fb17 100644 --- a/core/shared/src/main/scala/org/threeten/bp/package.scala +++ b/core/shared/src/main/scala/org/threeten/bp/package.scala @@ -53,7 +53,7 @@ package org.threeten * ==Dates and Times== * * {@link org.threeten.bp.Instant} is essentially a numeric timestamp. The current Instant can be - * retrieved from a {@link org.threeten.bp.Clock}. This is useful for logging and persistence of a + * retrieved from a {@link org.threeten.bp.Clock} . This is useful for logging and persistence of a * point in time and has in the past been associated with storing the result from {@link * java.lang.System#currentTimeMillis()}. * diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/Temporal.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/Temporal.scala index 37011c101..01f064496 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/Temporal.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/Temporal.scala @@ -37,7 +37,7 @@ package org.threeten.bp.temporal * * This is the base interface type for date, time and offset objects that are complete enough to be * manipulated using plus and minus. It is implemented by those classes that can provide and - * manipulate information as {@link TemporalField fields} or {@link TemporalQuery queries}. See + * manipulate information as {@link TemporalField fields} or {@link TemporalQuery queries} . See * {@link TemporalAccessor} for the read-only version of this interface. * * Most date and time information can be represented as a number. These are modeled using {@code @@ -46,8 +46,8 @@ package org.threeten.bp.temporal * ChronoField} for the standard set of fields. * * Two pieces of date/time information cannot be represented by numbers, the {@link Chronology - * chronology} and the {@link ZoneId time-zone}. These can be accessed via {@link - * #query(TemporalQuery) queries} using the static methods defined on {@link TemporalQueries}. + * chronology} and the {@link ZoneId time-zone} . These can be accessed via {@link + * #query(TemporalQuery) queries} using the static methods defined on {@link TemporalQueries} . * * This interface is a framework-level interface that should not be widely used in application code. * Instead, applications should create and pass around instances of concrete types, such as {@code @@ -78,7 +78,7 @@ package org.threeten.bp.temporal * *Specification for implementors
This interface places no restrictions on the mutability * of implementations, however immutability is strongly recommended. All implementations must be - * {@link Comparable}. + * {@link Comparable} . */ trait Temporal extends TemporalAccessor { @@ -90,10 +90,10 @@ trait Temporal extends TemporalAccessor { * an exception. * *Specification for implementors
Implementations must check and handle all fields - * defined in {@link ChronoUnit}. If the field is supported, then true is returned, otherwise + * defined in {@link ChronoUnit} . If the field is supported, then true is returned, otherwise * false * - * If the field is not a {@code ChronoUnit}, then the result of this method is obtained by + * If the field is not a {@code ChronoUnit} , then the result of this method is obtained by * invoking {@code TemporalUnit.isSupportedBy(Temporal)} passing {@code this} as the argument. * * Implementations must not alter this object. @@ -111,7 +111,7 @@ trait Temporal extends TemporalAccessor { * This adjusts this date-time according to the rules of the specified adjuster. A simple adjuster * might simply set the one of the fields, such as the year field. A more complex adjuster might * set the date to the last day of the month. A selection of common adjustments is provided in - * {@link TemporalAdjusters}. These include finding the "last day of the month" and "next + * {@link TemporalAdjusters} . These include finding the "last day of the month" and "next * Wednesday". The adjuster is responsible for handling special cases, such as the varying lengths * of month and leap years. * @@ -139,8 +139,8 @@ trait Temporal extends TemporalAccessor { * Returns an object of the same type as this object with the specified field altered. * * This returns a new object based on this one with the value for the specified field changed. For - * example, on a {@code LocalDate}, this could be used to set the year, month or day-of-month. The - * returned object will have the same observable type as this object. + * example, on a {@code LocalDate} , this could be used to set the year, month or day-of-month. + * The returned object will have the same observable type as this object. * * In some cases, changing a field is not fully defined. For example, if the target object is a * date representing the 31st January, then changing the month to February would be unclear. In @@ -148,10 +148,10 @@ trait Temporal extends TemporalAccessor { * the previous valid date, which would be the last valid day of February in this example. * *Specification for implementors
Implementations must check and handle all fields - * defined in {@link ChronoField}. If the field is supported, then the adjustment must be + * defined in {@link ChronoField} . If the field is supported, then the adjustment must be * performed. If unsupported, then a {@code DateTimeException} must be thrown. * - * If the field is not a {@code ChronoField}, then the result of this method is obtained by + * If the field is not a {@code ChronoField} , then the result of this method is obtained by * invoking {@code TemporalField.adjustInto(Temporal, long)} passing {@code this} as the first * argument. * @@ -177,7 +177,7 @@ trait Temporal extends TemporalAccessor { * * This adjusts this temporal, adding according to the rules of the specified amount. The amount * is typically a {@link Period} but may be any other type implementing the {@link TemporalAmount} - * interface, such as {@link Duration}. + * interface, such as {@link Duration} . * * Some example code indicating how and why this method is used:date = date.plus(period); * // add a Period instance date = date.plus(duration); // add a Duration instance date = @@ -205,7 +205,7 @@ trait Temporal extends TemporalAccessor { * Returns an object of the same type as this object with the specified period added. * * This method returns a new object based on this one with the specified period added. For - * example, on a {@code LocalDate}, this could be used to add a number of years, months or days. + * example, on a {@code LocalDate} , this could be used to add a number of years, months or days. * The returned object will have the same observable type as this object. * * In some cases, changing a field is not fully defined. For example, if the target object is a @@ -213,17 +213,17 @@ trait Temporal extends TemporalAccessor { * the field is responsible for resolving the result. Typically it will choose the previous valid * date, which would be the last valid day of February in this example. * - * If the implementation represents a date-time that has boundaries, such as {@code LocalTime}, + * If the implementation represents a date-time that has boundaries, such as {@code LocalTime} , * then the permitted units must include the boundary unit, but no multiples of the boundary unit. * For example, {@code LocalTime} must accept {@code DAYS} but not {@code WEEKS} or {@code * MONTHS}. * *Specification for implementors
Implementations must check and handle all units defined - * in {@link ChronoUnit}. If the unit is supported, then the addition must be performed. If + * in {@link ChronoUnit} . If the unit is supported, then the addition must be performed. If * unsupported, then a {@code DateTimeException} must be thrown. * - * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking - * {@code TemporalUnit.addTo(Temporal, long)} passing {@code this} as the first argument. + * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by + * invoking {@code TemporalUnit.addTo(Temporal, long)} passing {@code this} as the first argument. * * Implementations must not alter either this object or the specified temporal object. Instead, an * adjusted copy of the original must be returned. This provides equivalent, safe behavior for @@ -247,7 +247,7 @@ trait Temporal extends TemporalAccessor { * * This adjusts this temporal, subtracting according to the rules of the specified amount. The * amount is typically a {@link Period} but may be any other type implementing the {@link - * TemporalAmount} interface, such as {@link Duration}. + * TemporalAmount} interface, such as {@link Duration} . * * Some example code indicating how and why this method is used:date = date.minus(period); * // subtract a Period instance date = date.minus(duration); // subtract a Duration instance date @@ -275,7 +275,7 @@ trait Temporal extends TemporalAccessor { * Returns an object of the same type as this object with the specified period subtracted. * * This method returns a new object based on this one with the specified period subtracted. For - * example, on a {@code LocalDate}, this could be used to subtract a number of years, months or + * example, on a {@code LocalDate} , this could be used to subtract a number of years, months or * days. The returned object will have the same observable type as this object. * * In some cases, changing a field is not fully defined. For example, if the target object is a @@ -283,7 +283,7 @@ trait Temporal extends TemporalAccessor { * this, the field is responsible for resolving the result. Typically it will choose the previous * valid date, which would be the last valid day of February in this example. * - * If the implementation represents a date-time that has boundaries, such as {@code LocalTime}, + * If the implementation represents a date-time that has boundaries, such as {@code LocalTime} , * then the permitted units must include the boundary unit, but no multiples of the boundary unit. * For example, {@code LocalTime} must accept {@code DAYS} but not {@code WEEKS} or {@code * MONTHS}. @@ -317,16 +317,17 @@ trait Temporal extends TemporalAccessor { * This calculates the period between two temporals in terms of a single unit. The start and end * points are {@code this} and the specified temporal. The result will be negative if the end is * before the start. For example, the period in hours between two temporal objects can be - * calculated using {@code startTime.until(endTime, HOURS)}. + * calculated using {@code startTime.until(endTime, HOURS)} . * * The calculation returns a whole number, representing the number of complete units between the * two temporals. For example, the period in hours between the times 11:30 and 13:29 will only be * one hour as it is one minute short of two hours. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link TemporalUnit#between(Temporal, Temporal)}:// these - * two lines are equivalent between = thisUnit.between(start, end); between = start.until(end, - * thisUnit);The choice should be made based on which makes the code more readable. + * directly. The second is to use {@link TemporalUnit#between(Temporal, Temporal)} :// + * these two lines are equivalent between = thisUnit.between(start, end); between = + * start.until(end, thisUnit);The choice should be made based on which makes the code more + * readable. * * For example, this method allows the number of days between two dates to be calculated:* val daysBetween: Long = DAYS.between(start, end); // or alternatively val daysBetween: Long = @@ -334,12 +335,12 @@ trait Temporal extends TemporalAccessor { * *Specification for implementors
Implementations must begin by checking to ensure that * the input temporal object is of the same observable type as the implementation. They must then - * perform the calculation for all instances of {@link ChronoUnit}. A {@code DateTimeException} + * perform the calculation for all instances of {@link ChronoUnit} . A {@code DateTimeException} * must be thrown for {@code ChronoUnit} instances that are unsupported. * - * If the unit is not a {@code ChronoUnit}, then the result of this method is obtained by invoking - * {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first argument and - * the input temporal as the second argument. + * If the unit is not a {@code ChronoUnit} , then the result of this method is obtained by + * invoking {@code TemporalUnit.between(Temporal, Temporal)} passing {@code this} as the first + * argument and the input temporal as the second argument. * * In summary, implementations must behave in a manner equivalent to this code:// check * input temporal is the same type as this class if (unit instanceof ChronoUnit) { // if unit is diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAccessor.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAccessor.scala index 5d3791093..0d5017f97 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAccessor.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAccessor.scala @@ -45,10 +45,10 @@ package org.threeten.bp.temporal * ChronoField} for the standard set of fields. * * Two pieces of date/time information cannot be represented by numbers, the {@link Chronology - * chronology} and the {@link ZoneId time-zone}. These can be accessed via {@link - * #query(TemporalQuery) queries} using the static methods defined on {@link TemporalQueries}. + * chronology} and the {@link ZoneId time-zone} . These can be accessed via {@link + * #query(TemporalQuery) queries} using the static methods defined on {@link TemporalQueries} . * - * A sub-interface, {@link Temporal}, extends this definition to one that also supports adjustment + * A sub-interface, {@link Temporal} , extends this definition to one that also supports adjustment * and manipulation on more complete temporal objects. * * This interface is a framework-level interface that should not be widely used in application code. @@ -70,10 +70,10 @@ trait TemporalAccessor { * exception. * *Specification for implementors
Implementations must check and handle all fields - * defined in {@link ChronoField}. If the field is supported, then true is returned, otherwise + * defined in {@link ChronoField} . If the field is supported, then true is returned, otherwise * false * - * If the field is not a {@code ChronoField}, then the result of this method is obtained by + * If the field is not a {@code ChronoField} , then the result of this method is obtained by * invoking {@code TemporalField.isSupportedBy(TemporalAccessor)} passing {@code this} as the * argument. * @@ -99,10 +99,10 @@ trait TemporalAccessor { * invalid for the field. * *Specification for implementors
Implementations must check and handle all fields - * defined in {@link ChronoField}. If the field is supported, then the range of the field must be + * defined in {@link ChronoField} . If the field is supported, then the range of the field must be * returned. If unsupported, then a {@code DateTimeException} must be thrown. * - * If the field is not a {@code ChronoField}, then the result of this method is obtained by + * If the field is not a {@code ChronoField} , then the result of this method is obtained by * invoking {@code TemporalField.rangeRefinedBy(TemporalAccessorl)} passing {@code this} as the * argument. * @@ -123,18 +123,18 @@ trait TemporalAccessor { field.rangeRefinedBy(this) /** - * Gets the value of the specified field as an {@code int}. + * Gets the value of the specified field as an {@code int} . * * This queries the date-time for the value for the specified field. The returned value will * always be within the valid range of values for the field. If the date-time cannot return the * value, because the field is unsupported or for some other reason, an exception will be thrown. * *Specification for implementors
Implementations must check and handle all fields - * defined in {@link ChronoField}. If the field is supported and has an {@code int} range, then + * defined in {@link ChronoField} . If the field is supported and has an {@code int} range, then * the value of the field must be returned. If unsupported, then a {@code DateTimeException} must * be thrown. * - * If the field is not a {@code ChronoField}, then the result of this method is obtained by + * If the field is not a {@code ChronoField} , then the result of this method is obtained by * invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument. * * Implementations must not alter either this object. @@ -146,7 +146,7 @@ trait TemporalAccessor { * @throws DateTimeException * if a value for the field cannot be obtained * @throws DateTimeException - * if the range of valid values for the field exceeds an { @code int} + * if the range of valid values for the field exceeds an {@code int} * @throws DateTimeException * if the value is outside the range of valid values for the field * @throws ArithmeticException @@ -155,17 +155,17 @@ trait TemporalAccessor { def get(field: TemporalField): Int = range(field).checkValidIntValue(getLong(field), field) /** - * Gets the value of the specified field as a {@code long}. + * Gets the value of the specified field as a {@code long} . * * This queries the date-time for the value for the specified field. The returned value may be * outside the valid range of values for the field. If the date-time cannot return the value, * because the field is unsupported or for some other reason, an exception will be thrown. * *Specification for implementors
Implementations must check and handle all fields - * defined in {@link ChronoField}. If the field is supported, then the value of the field must be + * defined in {@link ChronoField} . If the field is supported, then the value of the field must be * returned. If unsupported, then a {@code DateTimeException} must be thrown. * - * If the field is not a {@code ChronoField}, then the result of this method is obtained by + * If the field is not a {@code ChronoField} , then the result of this method is obtained by * invoking {@code TemporalField.getFrom(TemporalAccessor)} passing {@code this} as the argument. * * Implementations must not alter either this object. @@ -192,7 +192,7 @@ trait TemporalAccessor { * year, or calculates the number of days to your next birthday. * * The most common query implementations are method references, such as {@code LocalDate::from} - * and {@code ZoneId::from}. Further implementations are on {@link TemporalQueries}. Queries may + * and {@code ZoneId::from} . Further implementations are on {@link TemporalQueries} . Queries may * also be defined by applications. * *Specification for implementors
Implementations of this method must behave as follows: diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjuster.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjuster.scala index c9ef184d2..7bd49f642 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjuster.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjuster.scala @@ -39,12 +39,12 @@ package org.threeten.bp.temporal * be an adjuster that sets the date avoiding weekends, or one that sets the date to the last day of * the month. * - * There are two equivalent ways of using a {@code TemporalAdjuster}. The first is to invoke the - * method on this interface directly. The second is to use {@link Temporal#with(TemporalAdjuster)}: + * There are two equivalent ways of using a {@code TemporalAdjuster} . The first is to invoke the + * method on this interface directly. The second is to use {@link Temporal#with(TemporalAdjuster)} : *// these two lines are equivalent, but the second approach is recommended temporal = * thisAdjuster.adjustInto(temporal); temporal = temporal.with(thisAdjuster);It is - * recommended to use the second approach, {@code with(TemporalAdjuster)}, as it is a lot clearer to - * read in code. + * recommended to use the second approach, {@code with(TemporalAdjuster)} , as it is a lot clearer + * to read in code. * * See {@link TemporalAdjusters} for a standard set of adjusters, including finding the last day of * the month. Adjusters may also be defined by applications. @@ -62,10 +62,10 @@ trait TemporalAdjuster { * date to the last day of the month. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link Temporal#with(TemporalAdjuster)}:// these two + * directly. The second is to use {@link Temporal#with(TemporalAdjuster)} :// these two * lines are equivalent, but the second approach is recommended temporal = * thisAdjuster.adjustInto(temporal); temporal = temporal.with(thisAdjuster);It is - * recommended to use the second approach, {@code with(TemporalAdjuster)}, as it is a lot clearer + * recommended to use the second approach, {@code with(TemporalAdjuster)} , as it is a lot clearer * to read in code. * *Specification for implementors
The implementation must take the input object and @@ -79,7 +79,7 @@ trait TemporalAdjuster { * * The input temporal object may be in a calendar system other than ISO. Implementations may * choose to document compatibility with other calendar systems, or reject non-ISO temporal - * objects by {@link TemporalQueries#chronology() querying the chronology}. + * objects by {@link TemporalQueries#chronology() querying the chronology} . * * This method may be called from multiple threads in parallel. It must be thread-safe when * invoked. diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjusters.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjusters.scala index 8c0e4fb28..fc097e43a 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjusters.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAdjusters.scala @@ -42,16 +42,16 @@ import org.threeten.bp.LocalDate import org.threeten.bp.DayOfWeek /** - * Common implementations of {@code TemporalAdjuster}. + * Common implementations of {@code TemporalAdjuster} . * - * This class provides common implementations of {@link TemporalAdjuster}. They are especially + * This class provides common implementations of {@link TemporalAdjuster} . They are especially * useful to document the intent of business logic and often link well to requirements. For example, * these two pieces of code do the same thing, but the second one is clearer (assuming that there is * a static import of this class):// direct manipulation * date.withDayOfMonth(1).plusMonths(1).minusDays(1); // use of an adjuster from this class * date.with(lastDayOfMonth());There are two equivalent ways of using a {@code * TemporalAdjuster}. The first is to invoke the method on the interface directly. The second is to - * use {@link Temporal#with(TemporalAdjuster)}:// these two lines are equivalent, but the + * use {@link Temporal#with(TemporalAdjuster)} :// these two lines are equivalent, but the * second approach is recommended dateTime = adjuster.adjustInto(dateTime); dateTime = * dateTime.with(adjuster);It is recommended to use the second approach, {@code * with(TemporalAdjuster)}, as it is a lot clearer to read in code. diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAmount.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAmount.scala index 930784614..859386476 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAmount.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalAmount.scala @@ -39,7 +39,7 @@ package org.threeten.bp.temporal * time-of-day in that it is not tied to any specific point on the time-line. * * The amount can be thought of as a Map of {@code TemporalUnit} to long, exposed via {@link - * #getUnits()} and {@link #get(TemporalUnit)}. A simple case might have a single unit-value pair, + * #getUnits()} and {@link #get(TemporalUnit)} . A simple case might have a single unit-value pair, * such as "6 hours". A more complex case may have multiple unit-value pairs, such as "7 years, 3 * months and 5 days". * @@ -50,7 +50,7 @@ package org.threeten.bp.temporal * * This interface is a framework-level interface that should not be widely used in application code. * Instead, applications should create and pass around instances of concrete types, such as {@code - * Period} and {@code Duration}. + * Period} and {@code Duration} . * *Specification for implementors
This interface places no restrictions on the mutability * of implementations, however immutability is strongly recommended. @@ -84,7 +84,7 @@ trait TemporalAmount { * class. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link Temporal#plus(TemporalAmount)}:// these two lines + * directly. The second is to use {@link Temporal#plus(TemporalAmount)} :// these two lines * are equivalent, but the second approach is recommended dateTime = amount.addTo(dateTime); * dateTime = dateTime.plus(amount);It is recommended to use the second approach, {@code * plus(TemporalAmount)}, as it is a lot clearer to read in code. @@ -99,7 +99,7 @@ trait TemporalAmount { * * The input temporal object may be in a calendar system other than ISO. Implementations may * choose to document compatibility with other calendar systems, or reject non-ISO temporal - * objects by {@link TemporalQueries#chronology() querying the chronology}. + * objects by {@link TemporalQueries#chronology() querying the chronology} . * * This method may be called from multiple threads in parallel. It must be thread-safe when * invoked. @@ -122,10 +122,11 @@ trait TemporalAmount { * class. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link Temporal#minus(TemporalAmount)}:// these two lines - * are equivalent, but the second approach is recommended dateTime = + * directly. The second is to use {@link Temporal#minus(TemporalAmount)} :// these two + * lines are equivalent, but the second approach is recommended dateTime = * amount.subtractFrom(dateTime); dateTime = dateTime.minus(amount);It is recommended to - * use the second approach, {@code minus(TemporalAmount)}, as it is a lot clearer to read in code. + * use the second approach, {@code minus(TemporalAmount)} , as it is a lot clearer to read in + * code. * *Specification for implementors
The implementation must take the input object and * subtract from it. The implementation defines the logic of the subtraction and is responsible @@ -138,7 +139,7 @@ trait TemporalAmount { * * The input temporal object may be in a calendar system other than ISO. Implementations may * choose to document compatibility with other calendar systems, or reject non-ISO temporal - * objects by {@link TemporalQueries#chronology() querying the chronology}. + * objects by {@link TemporalQueries#chronology() querying the chronology} . * * This method may be called from multiple threads in parallel. It must be thread-safe when * invoked. diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalField.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalField.scala index a88843563..46b6e2d12 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalField.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalField.scala @@ -40,12 +40,12 @@ import org.threeten.bp.format.ResolverStyle * Date and time is expressed using fields which partition the time-line into something meaningful * for humans. Implementations of this interface represent those fields. * - * The most commonly used units are defined in {@link ChronoField}. Further fields are supplied in - * {@link IsoFields}, {@link WeekFields} and {@link JulianFields}. Fields can also be written by + * The most commonly used units are defined in {@link ChronoField} . Further fields are supplied in + * {@link IsoFields} , {@link WeekFields} and {@link JulianFields} . Fields can also be written by * application code by implementing this interface. * * The field works using double dispatch. Client code calls methods on a date-time like {@code - * LocalDateTime} which check if the field is a {@code ChronoField}. If it is, then the date-time + * LocalDateTime} which check if the field is a {@code ChronoField} . If it is, then the date-time * must handle it. Otherwise, the method call is re-dispatched to the matching method in this * interface. * @@ -60,7 +60,7 @@ trait TemporalField { * Gets the unit that the field is measured in. * * The unit of the field is the period that varies within the range. For example, in the field - * 'MonthOfYear', the unit is 'Months'. See also {@link #getRangeUnit()}. + * 'MonthOfYear', the unit is 'Months'. See also {@link #getRangeUnit()} . * * @return * the period unit defining the base unit of the field, not null @@ -71,7 +71,7 @@ trait TemporalField { * Gets the range that the field is bound by. * * The range of the field is the period that the field varies within. For example, in the field - * 'MonthOfYear', the range is 'Years'. See also {@link #getBaseUnit()}. + * 'MonthOfYear', the range is 'Years'. See also {@link #getBaseUnit()} . * * The range is never null. For example, the 'Year' field is shorthand for 'YearOfForever'. It * therefore has a unit of 'Years' and a range of 'Forever'. @@ -124,14 +124,14 @@ trait TemporalField { * the temporal cannot be queried for this field. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link TemporalAccessor#isSupported(TemporalField)}:// + * directly. The second is to use {@link TemporalAccessor#isSupported(TemporalField)} :// * these two lines are equivalent, but the second approach is recommended temporal = * thisField.isSupportedBy(temporal); temporal = temporal.isSupported(thisField);It is - * recommended to use the second approach, {@code isSupported(TemporalField)}, as it is a lot + * recommended to use the second approach, {@code isSupported(TemporalField)} , as it is a lot * clearer to read in code. * * Implementations should determine whether they are supported using the fields available in - * {@link ChronoField}. + * {@link ChronoField} . * * @param temporal * the temporal object to query, not null @@ -144,17 +144,17 @@ trait TemporalField { * Get the range of valid values for this field using the temporal object to refine the result. * * This uses the temporal object to find the range of valid values for the field. This is similar - * to {@link #range()}, however this method refines the result using the temporal. For example, if - * the field is {@code DAY_OF_MONTH} the {@code range} method is not accurate as there are four + * to {@link #range()} , however this method refines the result using the temporal. For example, + * if the field is {@code DAY_OF_MONTH} the {@code range} method is not accurate as there are four * possible month lengths, 28, 29, 30 and 31 days. Using this method with a date allows the range * to be accurate, returning just one of those four options. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link TemporalAccessor#range(TemporalField)}:// these + * directly. The second is to use {@link TemporalAccessor#range(TemporalField)} :// these * two lines are equivalent, but the second approach is recommended temporal = * thisField.rangeRefinedBy(temporal); temporal = temporal.range(thisField);It is - * recommended to use the second approach, {@code range(TemporalField)}, as it is a lot clearer to - * read in code. + * recommended to use the second approach, {@code range(TemporalField)} , as it is a lot clearer + * to read in code. * * Implementations should perform any queries or calculations using the fields available in {@link * ChronoField}. If the field is not supported a {@code DateTimeException} must be thrown. @@ -197,7 +197,7 @@ trait TemporalField { * * If there is no display name for the locale then a suitable default must be returned. * - * The default implementation must check the locale is not null and return {@code toString()}. + * The default implementation must check the locale is not null and return {@code toString()} . * * @param locale * the locale to use, not null @@ -210,7 +210,7 @@ trait TemporalField { * Returns a copy of the specified temporal object with the value of this field set. * * This returns a new temporal object based on the specified one with the value for this field - * changed. For example, on a {@code LocalDate}, this could be used to set the year, month or + * changed. For example, on a {@code LocalDate} , this could be used to set the year, month or * day-of-month. The returned object has the same observable type as the specified object. * * In some cases, changing a field is not fully defined. For example, if the target object is a @@ -219,10 +219,10 @@ trait TemporalField { * choose the previous valid date, which would be the last valid day of February in this example. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link Temporal#with(TemporalField, long)}:// these two + * directly. The second is to use {@link Temporal#with(TemporalField, long)} :// these two * lines are equivalent, but the second approach is recommended temporal = * thisField.adjustInto(temporal); temporal = temporal.with(thisField);It is recommended - * to use the second approach, {@code with(TemporalField)}, as it is a lot clearer to read in + * to use the second approach, {@code with(TemporalField)} , as it is a lot clearer to read in * code. * * Implementations should perform any queries or calculations using the fields available in {@link @@ -249,7 +249,7 @@ trait TemporalField { * Resolves the date/time information in the builder * * This method is invoked during the resolve of the builder. Implementations should combine the - * associated field with others to form objects like {@code LocalDate}, {@code LocalTime} and + * associated field with others to form objects like {@code LocalDate} , {@code LocalTime} and * {@code LocalDateTime} * * @param fieldValues diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQueries.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQueries.scala index a301cc11d..338b0cccb 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQueries.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQueries.scala @@ -41,19 +41,20 @@ import org.threeten.bp.ZoneOffset import org.threeten.bp.chrono.Chronology /** - * Common implementations of {@code TemporalQuery}. + * Common implementations of {@code TemporalQuery} . * - * This class provides common implementations of {@link TemporalQuery}. These queries are primarily + * This class provides common implementations of {@link TemporalQuery} . These queries are primarily * used as optimizations, allowing the internals of other objects to be extracted effectively. Note * that application code can also use the {@code from(TemporalAccessor)} method on most temporal * objects as a method reference matching the query interface, such as {@code LocalDate::from} and - * {@code ZoneId::from}. + * {@code ZoneId::from} . * - * There are two equivalent ways of using a {@code TemporalQuery}. The first is to invoke the method - * on the interface directly. The second is to use {@link TemporalAccessor#query(TemporalQuery)}: - *// these two lines are equivalent, but the second approach is recommended dateTime = - * query.queryFrom(dateTime); dateTime = dateTime.query(query);It is recommended to use the - * second approach, {@code query(TemporalQuery)}, as it is a lot clearer to read in code. + * There are two equivalent ways of using a {@code TemporalQuery} . The first is to invoke the + * method on the interface directly. The second is to use + * {@link TemporalAccessor#query(TemporalQuery)} :// these two lines are equivalent, but the + * second approach is recommended dateTime = query.queryFrom(dateTime); dateTime = + * dateTime.query(query);It is recommended to use the second approach, + * {@code query(TemporalQuery)} , as it is a lot clearer to read in code. * *Specification for implementors
This is a thread-safe utility class. All returned * adjusters are immutable and thread-safe. @@ -61,12 +62,12 @@ import org.threeten.bp.chrono.Chronology object TemporalQueries { /** - * A strict query for the {@code ZoneId}. + * A strict query for the {@code ZoneId} . * * This queries a {@code TemporalAccessor} for the zone. The zone is only returned if the - * date-time conceptually contains a {@code ZoneId}. It will not be returned if the date-time only - * conceptually has an {@code ZoneOffset}. Thus a {@link ZonedDateTime} will return the result of - * {@code getZone()}, but an {@link OffsetDateTime} will return null. + * date-time conceptually contains a {@code ZoneId} . It will not be returned if the date-time + * only conceptually has an {@code ZoneOffset} . Thus a {@link ZonedDateTime} will return the + * result of {@code getZone()} , but an {@link OffsetDateTime} will return null. * * In most cases, applications should use {@link #ZONE} as this query is too strict. * @@ -87,29 +88,29 @@ object TemporalQueries { } /** - * A query for the {@code Chronology}. + * A query for the {@code Chronology} . * * This queries a {@code TemporalAccessor} for the chronology. If the target {@code * TemporalAccessor} represents a date, or part of a date, then it should return the chronology * that the date is expressed in. As a result of this definition, objects only representing time, - * such as {@code LocalTime}, will return null. + * such as {@code LocalTime} , will return null. * * The result from JDK classes implementing {@code TemporalAccessor} is as follows:
{@code - * LocalDate} returns {@code IsoChronology.INSTANCE}
{@code LocalTime} returns null (does not - * represent a date)
{@code LocalDateTime} returns {@code IsoChronology.INSTANCE}
{@code - * ZonedDateTime} returns {@code IsoChronology.INSTANCE}
{@code OffsetTime} returns null (does - * not represent a date)
{@code OffsetDateTime} returns {@code IsoChronology.INSTANCE}
- * {@code ChronoLocalDate} returns the associated chronology
{@code ChronoLocalDateTime} + * LocalDate} returns {@code IsoChronology.INSTANCE}
{@code LocalTime} returns null (does not + * represent a date)
{@code LocalDateTime} returns {@code IsoChronology.INSTANCE}
{@code + * ZonedDateTime} returns {@code IsoChronology.INSTANCE}
{@code OffsetTime} returns null + * (does not represent a date)
{@code OffsetDateTime} returns {@code IsoChronology.INSTANCE} + *
{@code ChronoLocalDate} returns the associated chronology
{@code ChronoLocalDateTime} * returns the associated chronology
{@code ChronoZonedDateTime} returns the associated * chronology
{@code Era} returns the associated chronology
{@code DayOfWeek} returns null - * (shared across chronologies)
{@code Month} returns {@code IsoChronology.INSTANCE}
- * {@code Year} returns {@code IsoChronology.INSTANCE}
{@code YearMonth} returns {@code - * IsoChronology.INSTANCE}
{@code MonthDay} returns null {@code IsoChronology.INSTANCE}
+ * (shared across chronologies)
{@code Month} returns {@code IsoChronology.INSTANCE}
+ * {@code Year} returns {@code IsoChronology.INSTANCE}
{@code YearMonth} returns {@code + * IsoChronology.INSTANCE}
{@code MonthDay} returns null {@code IsoChronology.INSTANCE}
* {@code ZoneOffset} returns null (does not represent a date)
{@code Instant} returns null * (does not represent a date)
* * The method {@link Chronology#from(TemporalAccessor)} can be used as a {@code TemporalQuery} via - * a method reference, {@code Chrono::from}. That method is equivalent to this query, except that + * a method reference, {@code Chrono::from} . That method is equivalent to this query, except that * it throws an exception if a chronology cannot be obtained. * * @return @@ -131,15 +132,16 @@ object TemporalQueries { * MILLIS}. * * The result from JDK classes implementing {@code TemporalAccessor} is as follows:
{@code - * LocalDate} returns {@code DAYS}
{@code LocalTime} returns {@code NANOS}
{@code - * LocalDateTime} returns {@code NANOS}
{@code ZonedDateTime} returns {@code NANOS}
{@code - * OffsetTime} returns {@code NANOS}
{@code OffsetDateTime} returns {@code NANOS}
{@code - * ChronoLocalDate} returns {@code DAYS}
{@code ChronoLocalDateTime} returns {@code NANOS}
- * {@code ChronoZonedDateTime} returns {@code NANOS}
{@code Era} returns {@code ERAS}
- * {@code DayOfWeek} returns {@code DAYS}
{@code Month} returns {@code MONTHS}
{@code - * Year} returns {@code YEARS}
{@code YearMonth} returns {@code MONTHS}
{@code MonthDay} - * returns null (does not represent a complete date or time)
{@code ZoneOffset} returns null - * (does not represent a date or time)
{@code Instant} returns {@code NANOS}
+ * LocalDate} returns {@code DAYS}
{@code LocalTime} returns {@code NANOS}
{@code + * LocalDateTime} returns {@code NANOS}
{@code ZonedDateTime} returns {@code NANOS}
+ * {@code OffsetTime} returns {@code NANOS}
{@code OffsetDateTime} returns {@code NANOS}
+ * {@code ChronoLocalDate} returns {@code DAYS}
{@code ChronoLocalDateTime} returns + * {@code NANOS}
{@code ChronoZonedDateTime} returns {@code NANOS}
{@code Era} returns + * {@code ERAS}
{@code DayOfWeek} returns {@code DAYS}
{@code Month} returns + * {@code MONTHS}
{@code Year} returns {@code YEARS}
{@code YearMonth} returns + * {@code MONTHS}
{@code MonthDay} returns null (does not represent a complete date or + * time)
{@code ZoneOffset} returns null (does not represent a date or time)
+ * {@code Instant} returns {@code NANOS}
* * @return * a query that can obtain the precision of a temporal, not null @@ -155,7 +157,7 @@ object TemporalQueries { * offset. The query will return null if the temporal object cannot supply an offset. * * The query implementation examines the {@link ChronoField#OFFSET_SECONDS OFFSET_SECONDS} field - * and uses it to create a {@code ZoneOffset}. + * and uses it to create a {@code ZoneOffset} . * * @return * a query that can obtain the offset of a temporal, not null @@ -168,19 +170,19 @@ object TemporalQueries { } /** - * A lenient query for the {@code ZoneId}, falling back to the {@code ZoneOffset}. + * A lenient query for the {@code ZoneId} , falling back to the {@code ZoneOffset} . * * This queries a {@code TemporalAccessor} for the zone. It first tries to obtain the zone, using - * {@link #zoneId()}. If that is not found it tries to obtain the {@link #offset()}. + * {@link #zoneId()} . If that is not found it tries to obtain the {@link #offset()} . * - * In most cases, applications should use this query rather than {@code #zoneId()}. + * In most cases, applications should use this query rather than {@code #zoneId()} . * * This query examines the {@link ChronoField#OFFSET_SECONDS offset-seconds} field and uses it to - * create a {@code ZoneOffset}. + * create a {@code ZoneOffset} . * * The method {@link ZoneId#from(TemporalAccessor)} can be used as a {@code TemporalQuery} via a - * method reference, {@code ZoneId::from}. That method is equivalent to this query, except that it - * throws an exception if a zone cannot be obtained. + * method reference, {@code ZoneId::from} . That method is equivalent to this query, except that + * it throws an exception if a zone cannot be obtained. * * @return * a query that can obtain the zone ID or offset of a temporal, not null @@ -199,7 +201,7 @@ object TemporalQueries { * date. The query will return null if the temporal object cannot supply a local date. * * The query implementation examines the {@link ChronoField#EPOCH_DAY EPOCH_DAY} field and uses it - * to create a {@code LocalDate}. + * to create a {@code LocalDate} . * * @return * a query that can obtain the date of a temporal, not null @@ -217,7 +219,7 @@ object TemporalQueries { * time. The query will return null if the temporal object cannot supply a local time. * * The query implementation examines the {@link ChronoField#NANO_OF_DAY NANO_OF_DAY} field and - * uses it to create a {@code LocalTime}. + * uses it to create a {@code LocalTime} . * * @return * a query that can obtain the date of a temporal, not null diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQuery.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQuery.scala index b31046027..14b4afe89 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQuery.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalQuery.scala @@ -40,16 +40,17 @@ package org.threeten.bp.temporal * leap year, or calculates the number of days to your next birthday. * * The {@link TemporalField} interface provides another mechanism for querying temporal objects. - * That interface is limited to returning a {@code long}. By contrast, queries can return any type. + * That interface is limited to returning a {@code long} . By contrast, queries can return any type. * - * There are two equivalent ways of using a {@code TemporalQuery}. The first is to invoke the method - * on this interface directly. The second is to use {@link TemporalAccessor#query(TemporalQuery)}: - *// these two lines are equivalent, but the second approach is recommended temporal = - * thisQuery.queryFrom(temporal); temporal = temporal.query(thisQuery);It is recommended to - * use the second approach, {@code query(TemporalQuery)}, as it is a lot clearer to read in code. + * There are two equivalent ways of using a {@code TemporalQuery} . The first is to invoke the + * method on this interface directly. The second is to use + * {@link TemporalAccessor#query(TemporalQuery)} :// these two lines are equivalent, but the + * second approach is recommended temporal = thisQuery.queryFrom(temporal); temporal = + * temporal.query(thisQuery);It is recommended to use the second approach, + * {@code query(TemporalQuery)} , as it is a lot clearer to read in code. * * The most common implementations are method references, such as {@code LocalDate::from} and {@code - * ZoneId::from}. Further implementations are on {@link TemporalQueries}. Queries may also be + * ZoneId::from}. Further implementations are on {@link TemporalQueries} . Queries may also be * defined by applications. * *Specification for implementors
This interface places no restrictions on the mutability @@ -65,10 +66,10 @@ trait TemporalQuery[+R] { * February 29th in a leap year, or calculates the number of days to your next birthday. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link TemporalAccessor#query(TemporalQuery)}:// these + * directly. The second is to use {@link TemporalAccessor#query(TemporalQuery)} :// these * two lines are equivalent, but the second approach is recommended temporal = * thisQuery.queryFrom(temporal); temporal = temporal.query(thisQuery);It is recommended - * to use the second approach, {@code query(TemporalQuery)}, as it is a lot clearer to read in + * to use the second approach, {@code query(TemporalQuery)} , as it is a lot clearer to read in * code. * *Specification for implementors
The implementation must take the input object and query @@ -78,7 +79,7 @@ trait TemporalQuery[+R] { * * The input temporal object may be in a calendar system other than ISO. Implementations may * choose to document compatibility with other calendar systems, or reject non-ISO temporal - * objects by {@link TemporalQueries#chronology() querying the chronology}. + * objects by {@link TemporalQueries#chronology() querying the chronology} . * * This method may be called from multiple threads in parallel. It must be thread-safe when * invoked. diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalUnit.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalUnit.scala index f7cd1668d..f15e75d94 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalUnit.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/TemporalUnit.scala @@ -42,12 +42,13 @@ import org.threeten.bp.Duration * An instance of this interface represents the unit itself, rather than an amount of the unit. See * {@link Period} for a class that represents an amount in terms of the common units. * - * The most commonly used units are defined in {@link ChronoUnit}. Further units are supplied in - * {@link IsoFields}. Units can also be written by application code by implementing this interface. + * The most commonly used units are defined in {@link ChronoUnit} . Further units are supplied in + * {@link IsoFields} . Units can also be written by application code by implementing this interface. * * The unit works using double dispatch. Client code calls methods on a date-time like {@code - * LocalDateTime} which check if the unit is a {@code ChronoUnit}. If it is, then the date-time must - * handle it. Otherwise, the method call is re-dispatched to the matching method in this interface. + * LocalDateTime} which check if the unit is a {@code ChronoUnit} . If it is, then the date-time + * must handle it. Otherwise, the method call is re-dispatched to the matching method in this + * interface. * *Specification for implementors
This interface must be implemented with care to ensure * other classes operate correctly. All implementations that can be instantiated must be final, @@ -64,7 +65,7 @@ trait TemporalUnit { * * Some units may return an accurate duration while others return an estimate. For example, days * have an estimated duration due to the possibility of daylight saving time changes. To determine - * if the duration is an estimate, use {@link #isDurationEstimated()}. + * if the duration is an estimate, use {@link #isDurationEstimated()} . * * @return * the duration of this unit, which may be an estimate, not null @@ -121,13 +122,13 @@ trait TemporalUnit { * and the period "3". The period to be added may be negative, which is equivalent to subtraction. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link Temporal#plus(long, TemporalUnit)}:// these two + * directly. The second is to use {@link Temporal#plus(long, TemporalUnit)} :// these two * lines are equivalent, but the second approach is recommended temporal = * thisUnit.doPlus(temporal); temporal = temporal.plus(thisUnit);It is recommended to use - * the second approach, {@code plus(TemporalUnit)}, as it is a lot clearer to read in code. + * the second approach, {@code plus(TemporalUnit)} , as it is a lot clearer to read in code. * * Implementations should perform any queries or calculations using the units available in {@link - * ChronoUnit} or the fields available in {@link ChronoField}. If the field is not supported a + * ChronoUnit} or the fields available in {@link ChronoField} . If the field is not supported a * {@code DateTimeException} must be thrown. * * Implementations must not alter the specified temporal object. Instead, an adjusted copy of the @@ -153,21 +154,21 @@ trait TemporalUnit { * This calculates the period between two temporals in terms of this unit. The start and end * points are supplied as temporal objects and must be of the same type. The result will be * negative if the end is before the start. For example, the period in hours between two temporal - * objects can be calculated using {@code HOURS.between(startTime, endTime)}. + * objects can be calculated using {@code HOURS.between(startTime, endTime)} . * * The calculation returns a whole number, representing the number of complete units between the * two temporals. For example, the period in hours between the times 11:30 and 13:29 will only b * one hour as it is one minute short of two hours. * * There are two equivalent ways of using this method. The first is to invoke this method - * directly. The second is to use {@link Temporal#until(Temporal, TemporalUnit)}:// these + * directly. The second is to use {@link Temporal#until(Temporal, TemporalUnit)} :// these * two lines are equivalent between = thisUnit.between(start, end); between = start.until(end, * thisUnit);The choice should be made based on which makes the code more readable. * * For example, this method allows the number of days between two dates to be calculated:* long daysBetween = DAYS.between(start, end); // or alternatively long daysBetween = * start.until(end, DAYS);Implementations should perform any queries or calculations using - * the units available in {@link ChronoUnit} or the fields available in {@link ChronoField}. If + * the units available in {@link ChronoUnit} or the fields available in {@link ChronoField} . If * the unit is not supported a DateTimeException must be thrown. Implementations must not alter * the specified temporal objects. * diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/ValueRange.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/ValueRange.scala index 826ee97c1..fbc596421 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/ValueRange.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/ValueRange.scala @@ -199,18 +199,18 @@ final class ValueRange private ( def getMaximum: Long = maxLargest /** - * Checks if all values in the range fit in an {@code int}. + * Checks if all values in the range fit in an {@code int} . * - * This checks that all valid values are within the bounds of an {@code int}. + * This checks that all valid values are within the bounds of an {@code int} . * - * For example, the ISO month-of-year has values from 1 to 12, which fits in an {@code int}. By + * For example, the ISO month-of-year has values from 1 to 12, which fits in an {@code int} . By * comparison, ISO nano-of-day runs from 1 to 86,400,000,000,000 which does not fit in an {@code * int}. * - * This implementation uses {@link #getMinimum()} and {@link #getMaximum()}. + * This implementation uses {@link #getMinimum()} and {@link #getMaximum()} . * * @return - * true if a valid value always fits in an { @code int} + * true if a valid value always fits in an {@code int} */ def isIntValue: Boolean = getMinimum >= Int.MinValue && getMaximum <= Int.MaxValue @@ -230,12 +230,12 @@ final class ValueRange private ( * Checks if the value is within the valid range and that all values in the range fit in an {@code * int}. * - * This method combines {@link #isIntValue()} and {@link #isValidValue(long)}. + * This method combines {@link #isIntValue()} and {@link #isValidValue(long)} . * * @param value * the value to check * @return - * true if the value is valid and fits in an { @code int} + * true if the value is valid and fits in an {@code int} */ def isValidIntValue(value: Long): Boolean = isIntValue && isValidValue(value) @@ -263,10 +263,10 @@ final class ValueRange private ( value /** - * Checks that the specified value is valid and fits in an {@code int}. + * Checks that the specified value is valid and fits in an {@code int} . * * This validates that the value is within the valid range of values and that all valid values are - * within the bounds of an {@code int}. The field is only used to improve the error message. + * within the bounds of an {@code int} . The field is only used to improve the error message. * * @param value * the value to check @@ -314,7 +314,7 @@ final class ValueRange private ( } /** - * Outputs this range as a {@code String}. + * Outputs this range as a {@code String} . * * The format will be '{min}/{largestMin} - {smallestMax}/{max}', where the largestMin or * smallestMax sections may be omitted, together with associated slash, if they are the same as diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/WeekFields.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/WeekFields.scala index 4d9c4acb1..b2c5bd6c3 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/WeekFields.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/WeekFields.scala @@ -327,7 +327,7 @@ object WeekFields { * Returns the week number computed from the reference day and reference dayOfWeek. * * @param offset - * the offset to align a date with the start of week from { @link #startOfWeekOffset}. + * the offset to align a date with the start of week from {@link #startOfWeekOffset} . * @param day * the day for which to compute the week number * @return @@ -557,11 +557,11 @@ object WeekFields { * aspects of a week. This class represents the definition of the week, for the purpose of providing * {@link TemporalField} instances. * - * WeekFields provides three fields, {@link #dayOfWeek()}, {@link #weekOfMonth()}, and {@link - * #weekOfYear()} that provide access to the values from any {@link Temporal temporal object}. + * WeekFields provides three fields, {@link #dayOfWeek()} , {@link #weekOfMonth()} , and {@link + * #weekOfYear()} that provide access to the values from any {@link Temporal temporal object} . * * The computations for day-of-week, week-of-month, and week-of-year are based on the {@link - * ChronoField#YEAR proleptic-year}, {@link ChronoField#MONTH_OF_YEAR month-of-year}, {@link + * ChronoField#YEAR proleptic-year}, {@link ChronoField#MONTH_OF_YEAR month-of-year} , {@link * ChronoField#DAY_OF_MONTH day-of-month}, and {@link ChronoField#DAY_OF_WEEK ISO day-of-week} which * are based on the {@link ChronoField#EPOCH_DAY epoch-day} and the chronology. The values may not * be aligned with the {@link ChronoField#YEAR_OF_ERA year-of-Era} depending on the Chronology. A @@ -609,10 +609,10 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v throw new IllegalArgumentException("Minimal number of days is invalid") /** - * Returns a field to access the day of week based on this {@code WeekFields}. + * Returns a field to access the day of week based on this {@code WeekFields} . * * This is similar to {@link ChronoField#DAY_OF_WEEK} but uses values for the day-of-week based on - * this {@code WeekFields}. The days are numbered from 1 to 7 where the {@link + * this {@code WeekFields} . The days are numbered from 1 to 7 where the {@link * #getFirstDayOfWeek() first day-of-week} is assigned the value 1. * * For example, if the first day-of-week is Sunday, then that will have the value 1, with other @@ -629,10 +629,10 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v val dayOfWeek: TemporalField = WeekFields.ComputedDayOfField.ofDayOfWeekField(this) /** - * Returns a field to access the week of month based on this {@code WeekFields}. + * Returns a field to access the week of month based on this {@code WeekFields} . * * This represents the concept of the count of weeks within the month where weeks start on a fixed - * day-of-week, such as Monday. This field is typically used with {@link WeekFields#dayOfWeek()}. + * day-of-week, such as Monday. This field is typically used with {@link WeekFields#dayOfWeek()} . * * Week one (1) is the week starting on the {@link WeekFields#getFirstDayOfWeek} where there are * at least {@link WeekFields#getMinimalDaysInFirstWeek()} days in the month. Thus, week one may @@ -654,15 +654,15 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v * In the resolving phase of parsing, a date can be created from a year, week-of-month, * month-of-year and day-of-week. * - * In {@linkplain ResolverStyle#STRICT strict mode}, all four fields are validated against their + * In {@linkplain ResolverStyle#STRICT strict mode} , all four fields are validated against their * range of valid values. The week-of-month field is validated to ensure that the resulting month * is the month requested. * - * In {@linkplain ResolverStyle#SMART smart mode}, all four fields are validated against their + * In {@linkplain ResolverStyle#SMART smart mode} , all four fields are validated against their * range of valid values. The week-of-month field is validated from 0 to 6, meaning that the * resulting date can be in a different month to that specified. * - * In {@linkplain ResolverStyle#LENIENT lenient mode}, the year and day-of-week are validated + * In {@linkplain ResolverStyle#LENIENT lenient mode} , the year and day-of-week are validated * against the range of valid values. The resulting date is calculated equivalent to the following * four stage approach. First, create a date on the first day of the first week of January in the * requested year. Then take the month-of-year, subtract one, and add the amount in months to the @@ -676,10 +676,10 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v val weekOfMonth: TemporalField = WeekFields.ComputedDayOfField.ofWeekOfMonthField(this) /** - * Returns a field to access the week of year based on this {@code WeekFields}. + * Returns a field to access the week of year based on this {@code WeekFields} . * * This represents the concept of the count of weeks within the year where weeks start on a fixed - * day-of-week, such as Monday. This field is typically used with {@link WeekFields#dayOfWeek()}. + * day-of-week, such as Monday. This field is typically used with {@link WeekFields#dayOfWeek()} . * * Week one(1) is the week starting on the {@link WeekFields#getFirstDayOfWeek} where there are at * least {@link WeekFields#getMinimalDaysInFirstWeek()} days in the year. Thus, week one may start @@ -701,15 +701,15 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v * In the resolving phase of parsing, a date can be created from a year, week-of-year and * day-of-week. * - * In {@linkplain ResolverStyle#STRICT strict mode}, all three fields are validated against their + * In {@linkplain ResolverStyle#STRICT strict mode} , all three fields are validated against their * range of valid values. The week-of-year field is validated to ensure that the resulting year is * the year requested. * - * In {@linkplain ResolverStyle#SMART smart mode}, all three fields are validated against their + * In {@linkplain ResolverStyle#SMART smart mode} , all three fields are validated against their * range of valid values. The week-of-year field is validated from 0 to 54, meaning that the * resulting date can be in a different year to that specified. * - * In {@linkplain ResolverStyle#LENIENT lenient mode}, the year and day-of-week are validated + * In {@linkplain ResolverStyle#LENIENT lenient mode} , the year and day-of-week are validated * against the range of valid values. The resulting date is calculated equivalent to the following * three stage approach. First, create a date on the first day of the first week in the requested * year. Then take the week-of-year, subtract one, and add the amount in weeks to the date. @@ -722,11 +722,11 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v val weekOfYear: TemporalField = WeekFields.ComputedDayOfField.ofWeekOfYearField(this) /** - * Returns a field to access the week of a week-based-year based on this {@code WeekFields}. + * Returns a field to access the week of a week-based-year based on this {@code WeekFields} . * * This represents the concept of the count of weeks within the year where weeks start on a fixed * day-of-week, such as Monday and each week belongs to exactly one year. This field is typically - * used with {@link WeekFields#dayOfWeek()} and {@link WeekFields#weekBasedYear()}. + * used with {@link WeekFields#dayOfWeek()} and {@link WeekFields#weekBasedYear()} . * * Week one(1) is the week starting on the {@link WeekFields#getFirstDayOfWeek} where there are at * least {@link WeekFields#getMinimalDaysInFirstWeek()} days in the year. If the first week starts @@ -746,15 +746,15 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v * In the resolving phase of parsing, a date can be created from a week-based-year, week-of-year * and day-of-week. * - * In {@linkplain ResolverStyle#STRICT strict mode}, all three fields are validated against their + * In {@linkplain ResolverStyle#STRICT strict mode} , all three fields are validated against their * range of valid values. The week-of-year field is validated to ensure that the resulting * week-based-year is the week-based-year requested. * - * In {@linkplain ResolverStyle#SMART smart mode}, all three fields are validated against their + * In {@linkplain ResolverStyle#SMART smart mode} , all three fields are validated against their * range of valid values. The week-of-week-based-year field is validated from 1 to 53, meaning * that the resulting date can be in the following week-based-year to that specified. * - * In {@linkplain ResolverStyle#LENIENT lenient mode}, the year and day-of-week are validated + * In {@linkplain ResolverStyle#LENIENT lenient mode} , the year and day-of-week are validated * against the range of valid values. The resulting date is calculated equivalent to the following * three stage approach. First, create a date on the first day of the first week in the requested * week-based-year. Then take the week-of-week-based-year, subtract one, and add the amount in @@ -768,11 +768,11 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v WeekFields.ComputedDayOfField.ofWeekOfWeekBasedYearField(this) /** - * Returns a field to access the year of a week-based-year based on this {@code WeekFields}. + * Returns a field to access the year of a week-based-year based on this {@code WeekFields} . * * This represents the concept of the year where weeks start on a fixed day-of-week, such as * Monday and each week belongs to exactly one year. This field is typically used with {@link - * WeekFields#dayOfWeek()} and {@link WeekFields#weekOfWeekBasedYear()}. + * WeekFields#dayOfWeek()} and {@link WeekFields#weekOfWeekBasedYear()} . * * Week one(1) is the week starting on the {@link WeekFields#getFirstDayOfWeek} where there are at * least {@link WeekFields#getMinimalDaysInFirstWeek()} days in the year. Thus, week one may start @@ -784,15 +784,15 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v * In the resolving phase of parsing, a date can be created from a week-based-year, week-of-year * and day-of-week. * - * In {@linkplain ResolverStyle#STRICT strict mode}, all three fields are validated against their + * In {@linkplain ResolverStyle#STRICT strict mode} , all three fields are validated against their * range of valid values. The week-of-year field is validated to ensure that the resulting * week-based-year is the week-based-year requested. * - * In {@linkplain ResolverStyle#SMART smart mode}, all three fields are validated against their + * In {@linkplain ResolverStyle#SMART smart mode} , all three fields are validated against their * range of valid values. The week-of-week-based-year field is validated from 1 to 53, meaning * that the resulting date can be in the following week-based-year to that specified. * - * In {@linkplain ResolverStyle#LENIENT lenient mode}, the year and day-of-week are validated + * In {@linkplain ResolverStyle#LENIENT lenient mode} , the year and day-of-week are validated * against the range of valid values. The resulting date is calculated equivalent to the following * three stage approach. First, create a date on the first day of the first week in the requested * week-based-year. Then take the week-of-week-based-year, subtract one, and add the amount in @@ -846,7 +846,7 @@ final class WeekFields private (private val firstDayOfWeek: DayOfWeek, private v } /** - * A hash code for this {@code WeekFields}. + * A hash code for this {@code WeekFields} . * * @return * a suitable hash code diff --git a/core/shared/src/main/scala/org/threeten/bp/temporal/package.scala b/core/shared/src/main/scala/org/threeten/bp/temporal/package.scala index 9c35a1235..ff548b7ee 100644 --- a/core/shared/src/main/scala/org/threeten/bp/temporal/package.scala +++ b/core/shared/src/main/scala/org/threeten/bp/temporal/package.scala @@ -52,10 +52,10 @@ package org.threeten.bp * to add their own units. * * A field is used to express part of a larger date-time, such as year, month-of-year or - * second-of-minute. All fields implement {@link org.threeten.bp.temporal.TemporalField}. The set of - * well known fields are defined in {@link org.threeten.bp.temporal.ChronoField}, for example, - * {@link org.threeten.bp.temporal.ChronoField#HOUR_OF_DAY}. An additional fields are defined by - * {@link org.threeten.bp.temporal.JulianFields}. The field interface is designed to allow + * second-of-minute. All fields implement {@link org.threeten.bp.temporal.TemporalField} . The set + * of well known fields are defined in {@link org.threeten.bp.temporal.ChronoField} , for example, + * {@link org.threeten.bp.temporal.ChronoField#HOUR_OF_DAY} . An additional fields are defined by + * {@link org.threeten.bp.temporal.JulianFields} . The field interface is designed to allow * applications to add their own fields. * * This package provides tools that allow the units and fields of date and time to be accessed in a @@ -66,8 +66,8 @@ package org.threeten.bp * * One use of fields in application code is to retrieve fields for which there is no convenience * method. For example, getting the day-of-month is common enough that there is a method on {@code - * LocalDate} called {@code getDayOfMonth()}. However for more unusual fields it is necessary to use - * the field. For example, {@code date.get(ChronoField.ALIGNED_WEEK_OF_MONTH)}. The fields also + * LocalDate} called {@code getDayOfMonth()} . However for more unusual fields it is necessary to + * use the field. For example, {@code date.get(ChronoField.ALIGNED_WEEK_OF_MONTH)} . The fields also * provide access to the range of valid values. * * ==Adjustment== @@ -75,8 +75,8 @@ package org.threeten.bp * A key part of the date-time problem space is adjusting a date to a new, related value, such as * the "last day of the month", or "next Wednesday". These are modeled as functions that adjust a * base date-time. The functions implement {@link org.threeten.bp.temporal.TemporalAdjuster} and - * operate on {@link org.threeten.bp.temporal.Temporal}. A set of common functions are provided in - * {@link org.threeten.bp.temporal.TemporalAdjusters}. For example, to find the first occurrence of + * operate on {@link org.threeten.bp.temporal.Temporal} . A set of common functions are provided in + * {@link org.threeten.bp.temporal.TemporalAdjusters} . For example, to find the first occurrence of * a day-of-week after a given date, use {@link * org.threeten.bp.temporal.TemporalAdjusters#next(DayOfWeek)}, such as {@code * date.with(next(MONDAY))}. diff --git a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneOffsetTransition.scala b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneOffsetTransition.scala index 0db7ee578..badff5e8d 100644 --- a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneOffsetTransition.scala +++ b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneOffsetTransition.scala @@ -46,12 +46,12 @@ import org.threeten.bp.ZoneOffset * models the transition between the two offsets. * * Gaps occur where there are local date-times that simply do not not exist. An example would be - * when the offset changes from {@code +03:00} to {@code +04:00}. This might be described as 'the + * when the offset changes from {@code +03:00} to {@code +04:00} . This might be described as 'the * clocks will move forward one hour tonight at 1am'. * * Overlaps occur where there are local date-times that exist twice. An example would be when the - * offset changes from {@code +04:00} to {@code +03:00}. This might be described as 'the clocks will - * move back one hour tonight at 2am'. + * offset changes from {@code +04:00} to {@code +03:00} . This might be described as 'the clocks + * will move back one hour tonight at 2am'. * *Specification for implementors
This class is immutable and thread-safe. */ @@ -60,8 +60,8 @@ object ZoneOffsetTransition { /** * Obtains an instance defining a transition between two offsets. * - * Applications should normally obtain an instance from {@link ZoneRules}. This factory is only - * intended for use when creating {@link ZoneRules}. + * Applications should normally obtain an instance from {@link ZoneRules} . This factory is only + * intended for use when creating {@link ZoneRules} . * * @param transition * the transition date-time at the transition, which never actually occurs, expressed local to @@ -73,7 +73,7 @@ object ZoneOffsetTransition { * @return * the transition, not null * @throws IllegalArgumentException - * if { @code offsetBefore} and { @code offsetAfter} are equal, or { @code transition.getNano()} + * if {@code offsetBefore} and {@code offsetAfter} are equal, or {@code transition.getNano()} * returns non-zero value */ def of( @@ -129,8 +129,8 @@ final class ZoneOffsetTransition private[zone] ( * This is the instant of the discontinuity, which is defined as the first instant that the * 'after' offset applies. * - * The methods {@link #getInstant()}, {@link #getDateTimeBefore()} and {@link #getDateTimeAfter()} - * all represent the same instant. + * The methods {@link #getInstant()} , {@link #getDateTimeBefore()} and + * {@link #getDateTimeAfter()} all represent the same instant. * * @return * the transition instant, not null @@ -218,7 +218,7 @@ final class ZoneOffsetTransition private[zone] ( * Does this transition represent a gap in the local time-line. * * Gaps occur where there are local date-times that simply do not not exist. An example would be - * when the offset changes from {@code +01:00} to {@code +02:00}. This might be described as 'the + * when the offset changes from {@code +01:00} to {@code +02:00} . This might be described as 'the * clocks will move forward one hour tonight at 1am'. * * @return @@ -230,7 +230,7 @@ final class ZoneOffsetTransition private[zone] ( * Does this transition represent a gap in the local time-line. * * Overlaps occur where there are local date-times that exist twice. An example would be when the - * offset changes from {@code +02:00} to {@code +01:00}. This might be described as 'the clocks + * offset changes from {@code +02:00} to {@code +01:00} . This might be described as 'the clocks * will move back one hour tonight at 2am'. * * @return diff --git a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRules.scala b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRules.scala index f5bd3dc8b..d46d75a30 100644 --- a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRules.scala +++ b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRules.scala @@ -46,7 +46,7 @@ import org.threeten.bp.ZoneOffset * ZoneOffsetTransitionRule} is used for future transitions that are based on the result of an * algorithm. * - * The rules are loaded via {@link ZoneRulesProvider} using a {@link ZoneId}. The same rules may be + * The rules are loaded via {@link ZoneRulesProvider} using a {@link ZoneId} . The same rules may be * shared internally between multiple zone IDs. * * Serializing an instance of {@code ZoneRules} will store the entire set of rules. It does not @@ -212,7 +212,7 @@ abstract class ZoneRules private[zone] () { * Since, in the case of Gap and Overlap, the offset returned is a "best" value, rather than the * "correct" value, it should be treated with care. Applications that care about the correct * offset should use a combination of this method, {@link #getValidOffsets(LocalDateTime)} and - * {@link #getTransition(LocalDateTime)}. + * {@link #getTransition(LocalDateTime)} . * * @param localDateTime * the local date-time to query, not null, but null may be ignored if the rules have a single @@ -237,7 +237,7 @@ abstract class ZoneRules private[zone] () { * offsets, which is a list of size 0, 1 or 2. In the case where there are two offsets, the * earlier offset is returned at index 0 and the later offset at index 1. * - * There are various ways to handle the conversion from a {@code LocalDateTime}. One technique, + * There are various ways to handle the conversion from a {@code LocalDateTime} . One technique, * using this method, would be:ListvalidOffsets = rules.getOffset(localDT); if * (validOffsets.size() == 1) { // Normal case: only one valid offset zoneOffset = * validOffsets.get(0); } else { // Gap or Overlap: determine what to do from transition (which @@ -269,7 +269,7 @@ abstract class ZoneRules private[zone] () { * local date-time values with two valid offsets.
A transition is used to model the * cases of a Gap or Overlap. The Normal case will return null. * - * There are various ways to handle the conversion from a {@code LocalDateTime}. One technique, + * There are various ways to handle the conversion from a {@code LocalDateTime} . One technique, * using this method, would be:
ZoneOffsetTransition trans = rules.getTransition(localDT); * if (trans == null) { // Gap or Overlap: determine what to do from transition } else { // Normal * case: only one valid offset zoneOffset = rule.getOffset(localDT); }@@ -395,9 +395,9 @@ abstract class ZoneRules private[zone] () { * #getTransitions()}. This method returns instances of {@link ZoneOffsetTransitionRule} that * define an algorithm for when transitions will occur. * - * For any given {@code ZoneRules}, this list contains the transition rules for years beyond those - * years that have been fully defined. These rules typically refer to future daylight saving time - * rule changes. + * For any given {@code ZoneRules} , this list contains the transition rules for years beyond + * those years that have been fully defined. These rules typically refer to future daylight saving + * time rule changes. * * If the zone defines daylight savings into the future, then the list will normally be of size * two and hold information about entering and exiting daylight savings. If the zone does not have @@ -429,7 +429,7 @@ abstract class ZoneRules private[zone] () { override def equals(otherRules: Any): Boolean /** - * Returns a suitable hash code given the definition of {@code #equals}. + * Returns a suitable hash code given the definition of {@code #equals} . * * @return * the hash code diff --git a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesBuilder.scala b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesBuilder.scala index 91cbd3db2..83a63c8ff 100644 --- a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesBuilder.scala +++ b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesBuilder.scala @@ -64,7 +64,7 @@ import org.threeten.bp.chrono.IsoChronology * windows can have the same standard offset. * * Within each window, there can either be a {@link #setFixedSavingsToWindow fixed savings amount} - * or a {@link #addRuleToWindow list of rules}. + * or a {@link #addRuleToWindow list of rules} . */ class ZoneRulesBuilder() { @@ -553,7 +553,7 @@ class ZoneRulesBuilder() { * the month of the transition, not null * @param dayOfMonthIndicator * the day-of-month of the transition, adjusted by dayOfWeek, from 1 to 31 adjusted later, or - * -1 to -28 adjusted earlier from the last day of the month + * -1 to -28 adjusted earlier from the last day of the month * @param dayOfWeek * the day-of-week to adjust to, null if day-of-month should not be adjusted * @param time diff --git a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesInitializer.scala b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesInitializer.scala index 5a40c806c..94ea357fa 100644 --- a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesInitializer.scala +++ b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesInitializer.scala @@ -36,7 +36,7 @@ import java.util.concurrent.atomic.AtomicReference /** * Controls how the time-zone rules are initialized.
The default behavior is to use {@link - * ServiceLoader} to find instances of {@link ZoneRulesProvider}. Use the {@link + * ServiceLoader} to find instances of {@link ZoneRulesProvider} . Use the {@link * #setInitializer(ZoneRulesInitializer)} method to replace this behavior. The initializer instance * must perform the work of creating the {@code ZoneRulesProvider} within the {@link * #initializeProviders()} method to ensure that the provider is not initialized too early.
diff --git a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesProvider.scala b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesProvider.scala
index 5aca943c8..bea5ea575 100644
--- a/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesProvider.scala
+++ b/core/shared/src/main/scala/org/threeten/bp/zone/ZoneRulesProvider.scala
@@ -49,7 +49,7 @@ object ZoneRulesProvider {
/**
* Gets the set of available zone IDs.
*
- * These zone IDs are loaded and available for use by {@code ZoneId}.
+ * These zone IDs are loaded and available for use by {@code ZoneId} .
*
* @return
* the unmodifiable copy of the set of zone IDs, not null
@@ -62,22 +62,22 @@ object ZoneRulesProvider {
* This returns the latest available rules for the zone ID.
*
* This method relies on time-zone data provider files that are configured. These are loaded using
- * a {@code ServiceLoader}.
+ * a {@code ServiceLoader} .
*
* The caching flag is designed to allow provider implementations to prevent the rules being
- * cached in {@code ZoneId}. Under normal circumstances, the caching of zone rules is highly
+ * cached in {@code ZoneId} . Under normal circumstances, the caching of zone rules is highly
* desirable as it will provide greater performance. However, there is a use case where the
- * caching would not be desirable, see {@link #provideRules}.
+ * caching would not be desirable, see {@link #provideRules} .
*
* @param zoneId
- * the zone ID as defined by { @code ZoneId}, not null
+ * the zone ID as defined by {@code ZoneId} , not null
* @param forCaching
* whether the rules are being queried for caching, true if the returned rules will be cached by
- * { @code ZoneId}, false if they will be returned to the user without being cached in { @code
+ * {@code ZoneId} , false if they will be returned to the user without being cached in { @code
* ZoneId}
* @return
- * the rules, null if { @code forCaching} is true and this is a dynamic provider that wants to
- * prevent caching in { @code ZoneId}, otherwise not null
+ * the rules, null if {@code forCaching} is true and this is a dynamic provider that wants to
+ * prevent caching in {@code ZoneId} , otherwise not null
* @throws ZoneRulesException
* if rules cannot be obtained for the zone ID
*/
@@ -103,7 +103,7 @@ object ZoneRulesProvider {
* more than one element if historical rule information is available.
*
* @param zoneId
- * the zone region ID as used by { @code ZoneId}, not null
+ * the zone region ID as used by {@code ZoneId} , not null
* @return
* a modifiable copy of the history of the rules for the ID, sorted from oldest to newest, not
* null
@@ -119,7 +119,7 @@ object ZoneRulesProvider {
* Gets the provider for the zone ID.
*
* @param zoneId
- * the zone region ID as used by { @code ZoneId}, not null
+ * the zone region ID as used by {@code ZoneId} , not null
* @return
* the provider, not null
* @throws ZoneRulesException
@@ -141,7 +141,7 @@ object ZoneRulesProvider {
*
* This adds a new provider to those currently available. A provider supplies rules for one or
* more zone IDs. A provider cannot be registered if it supplies a zone ID that has already been
- * registered. See the notes on time-zone IDs in {@link ZoneId}, especially the section on using
+ * registered. See the notes on time-zone IDs in {@link ZoneId} , especially the section on using
* the concept of a "group" to make IDs unique.
*
* To ensure the integrity of time-zones already created, there is no way to deregister providers.
@@ -214,7 +214,7 @@ object ZoneRulesProvider {
* API that can be used to manage the providers. The abstract methods provide the SPI that allows
* rules to be provided.
*
- * Rules are looked up primarily by zone ID, as used by {@link ZoneId}. Only zone region IDs may be
+ * Rules are looked up primarily by zone ID, as used by {@link ZoneId} . Only zone region IDs may be
* used, zone offset IDs are not used here.
*
* Time-zone rules are political, thus the data can change at any time. Each provider will provide
@@ -281,7 +281,7 @@ abstract class ZoneRulesProvider protected () {
* provider may increase the set of versions as more data becomes available.
*
* @param zoneId
- * the zone region ID as used by { @code ZoneId}, not null
+ * the zone region ID as used by {@code ZoneId} , not null
* @return
* a modifiable copy of the history of the rules for the ID, sorted from oldest to newest, not
* null
diff --git a/tests/shared/src/test/scala-2/org/threeten/bp/temporal/MockFieldNoValue.scala b/tests/shared/src/test/scala-2/org/threeten/bp/temporal/MockFieldNoValue.scala
index e1739cabb..204f7875c 100644
--- a/tests/shared/src/test/scala-2/org/threeten/bp/temporal/MockFieldNoValue.scala
+++ b/tests/shared/src/test/scala-2/org/threeten/bp/temporal/MockFieldNoValue.scala
@@ -45,18 +45,18 @@ object MockFieldNoValue {
final class MockFieldNoValue(name: String, ordinal: Int)
extends Enum[MockFieldNoValue](name, ordinal)
with TemporalField {
- override def toString: String = null
- def getBaseUnit: TemporalUnit = WEEKS
- def getRangeUnit: TemporalUnit = MONTHS
- def range: ValueRange = ValueRange.of(1, 20)
- def isDateBased: Boolean = true
- def isTimeBased: Boolean = false
- def isSupportedBy(dateTime: TemporalAccessor): Boolean = true
- def rangeRefinedBy(dateTime: TemporalAccessor): ValueRange = ValueRange.of(1, 20)
- def getFrom(dateTime: TemporalAccessor): Long = throw new DateTimeException("Mock")
- def adjustInto[R <: Temporal](dateTime: R, newValue: Long): R =
+ override def toString: String = null
+ def getBaseUnit: TemporalUnit = WEEKS
+ def getRangeUnit: TemporalUnit = MONTHS
+ def range: ValueRange = ValueRange.of(1, 20)
+ def isDateBased: Boolean = true
+ def isTimeBased: Boolean = false
+ def isSupportedBy(dateTime: TemporalAccessor): Boolean = true
+ def rangeRefinedBy(dateTime: TemporalAccessor): ValueRange = ValueRange.of(1, 20)
+ def getFrom(dateTime: TemporalAccessor): Long = throw new DateTimeException("Mock")
+ def adjustInto[R <: Temporal](dateTime: R, newValue: Long): R =
throw new DateTimeException("Mock")
- override def getDisplayName(locale: Locale): String = "Mock"
+ override def getDisplayName(locale: Locale): String = "Mock"
override def resolve(
fieldValues: java.util.Map[TemporalField, java.lang.Long],
partialTemporal: TemporalAccessor,
diff --git a/tests/shared/src/test/scala-3/org/threeten/bp/temporal/MockFieldNoValue.scala b/tests/shared/src/test/scala-3/org/threeten/bp/temporal/MockFieldNoValue.scala
index 47b01e282..44c9e13c2 100644
--- a/tests/shared/src/test/scala-3/org/threeten/bp/temporal/MockFieldNoValue.scala
+++ b/tests/shared/src/test/scala-3/org/threeten/bp/temporal/MockFieldNoValue.scala
@@ -42,18 +42,18 @@ enum MockFieldNoValue private (name: String, ordinal: Int)
extends Enum[MockFieldNoValue]
with TemporalField {
case INSTANCE extends MockFieldNoValue("INSTANCE", 0)
- override def toString: String = null
- def getBaseUnit: TemporalUnit = WEEKS
- def getRangeUnit: TemporalUnit = MONTHS
- def range: ValueRange = ValueRange.of(1, 20)
- def isDateBased: Boolean = true
- def isTimeBased: Boolean = false
- def isSupportedBy(dateTime: TemporalAccessor): Boolean = true
- def rangeRefinedBy(dateTime: TemporalAccessor): ValueRange = ValueRange.of(1, 20)
- def getFrom(dateTime: TemporalAccessor): Long = throw new DateTimeException("Mock")
- def adjustInto[R <: Temporal](dateTime: R, newValue: Long): R =
+ override def toString: String = null
+ def getBaseUnit: TemporalUnit = WEEKS
+ def getRangeUnit: TemporalUnit = MONTHS
+ def range: ValueRange = ValueRange.of(1, 20)
+ def isDateBased: Boolean = true
+ def isTimeBased: Boolean = false
+ def isSupportedBy(dateTime: TemporalAccessor): Boolean = true
+ def rangeRefinedBy(dateTime: TemporalAccessor): ValueRange = ValueRange.of(1, 20)
+ def getFrom(dateTime: TemporalAccessor): Long = throw new DateTimeException("Mock")
+ def adjustInto[R <: Temporal](dateTime: R, newValue: Long): R =
throw new DateTimeException("Mock")
- override def getDisplayName(locale: Locale): String = "Mock"
+ override def getDisplayName(locale: Locale): String = "Mock"
override def resolve(
fieldValues: java.util.Map[TemporalField, java.lang.Long],
partialTemporal: TemporalAccessor,
diff --git a/tests/shared/src/test/scala/org/threeten/bp/AssertionsHelper.scala b/tests/shared/src/test/scala/org/threeten/bp/AssertionsHelper.scala
index 2961d4963..0b62baf4e 100644
--- a/tests/shared/src/test/scala/org/threeten/bp/AssertionsHelper.scala
+++ b/tests/shared/src/test/scala/org/threeten/bp/AssertionsHelper.scala
@@ -17,27 +17,27 @@ trait AssertionsHelper { this: AnyFunSuite =>
true
def assertEquals[A, B](
- o1: A,
- o2: B,
- msg: String
+ o1: A,
+ o2: B,
+ msg: String
)(implicit prettifier: Prettifier, pos: source.Position): Assertion =
assert(o1 == o2, msg)
def assertEquals[A, B](
- o1: A,
- o2: B
+ o1: A,
+ o2: B
)(implicit prettifier: Prettifier, pos: source.Position): Assertion =
assert(o1 == o2)
def assertSame[A <: AnyRef, B <: AnyRef](
- o1: A,
- o2: B
+ o1: A,
+ o2: B
)(implicit prettifier: Prettifier, pos: source.Position): Assertion =
assert(o1 eq o2)
def assertNotEquals[A, B](
- o1: A,
- o2: B
+ o1: A,
+ o2: B
)(implicit prettifier: Prettifier, pos: source.Position): Assertion =
assert(o1 != o2)
@@ -51,8 +51,8 @@ trait AssertionsHelper { this: AnyFunSuite =>
assert(a == null)
def assertNotNull[A](
- a: A,
- msg: String
+ a: A,
+ msg: String
)(implicit prettifier: Prettifier, pos: source.Position): Assertion =
assert(a != null, msg)
diff --git a/tests/shared/src/test/scala/org/threeten/bp/MockSimplePeriod.scala b/tests/shared/src/test/scala/org/threeten/bp/MockSimplePeriod.scala
index fb35fbcfe..cddcc3718 100644
--- a/tests/shared/src/test/scala/org/threeten/bp/MockSimplePeriod.scala
+++ b/tests/shared/src/test/scala/org/threeten/bp/MockSimplePeriod.scala
@@ -54,9 +54,9 @@ object MockSimplePeriod {
* @param unit
* the unit that the period is measured in, must not be the 'Forever' unit, not null
* @return
- * the { @code MockSimplePeriod} instance, not null
+ * the {@code MockSimplePeriod} instance, not null
* @throws DateTimeException
- * if the period unit is { @link org.threeten.bp.temporal.ChronoUnit#FOREVER}.
+ * if the period unit is {@link org.threeten.bp.temporal.ChronoUnit#FOREVER} .
*/
def of(amount: Long, unit: TemporalUnit): MockSimplePeriod = new MockSimplePeriod(amount, unit)
}
diff --git a/tests/shared/src/test/scala/org/threeten/bp/TestInstant.scala b/tests/shared/src/test/scala/org/threeten/bp/TestInstant.scala
index b263dbb18..f7ba88da0 100644
--- a/tests/shared/src/test/scala/org/threeten/bp/TestInstant.scala
+++ b/tests/shared/src/test/scala/org/threeten/bp/TestInstant.scala
@@ -244,27 +244,27 @@ class TestInstant
List[Long](Long.MaxValue - 1,
0,
(Long.MaxValue - 1) / 1000,
- ((Long.MaxValue - 1) % 1000).toInt * 1000000
+ ((Long.MaxValue - 1) % 1000).toInt * 1000000
),
List[Long](Long.MinValue,
0,
(Long.MinValue / 1000) - 1,
- (Long.MinValue % 1000).toInt * 1000000 + 1000000000
+ (Long.MinValue % 1000).toInt * 1000000 + 1000000000
),
List[Long](Long.MinValue,
1,
(Long.MinValue / 1000) - 1,
- (Long.MinValue % 1000).toInt * 1000000 + 1000000000 + 1
+ (Long.MinValue % 1000).toInt * 1000000 + 1000000000 + 1
),
List[Long](Long.MinValue + 1,
0,
((Long.MinValue + 1) / 1000) - 1,
- ((Long.MinValue + 1) % 1000).toInt * 1000000 + 1000000000
+ ((Long.MinValue + 1) % 1000).toInt * 1000000 + 1000000000
),
List[Long](Long.MinValue + 1,
1,
((Long.MinValue + 1) / 1000) - 1,
- ((Long.MinValue + 1) % 1000).toInt * 1000000 + 1000000000 + 1
+ ((Long.MinValue + 1) % 1000).toInt * 1000000 + 1000000000 + 1
)
)
@@ -730,7 +730,7 @@ class TestInstant
0,
Long.MinValue,
Long.MinValue / 1000 - 1,
- (Long.MinValue % 1000).toInt * 1000000 + 1000000000
+ (Long.MinValue % 1000).toInt * 1000000 + 1000000000
)
)
diff --git a/tests/shared/src/test/scala/org/threeten/bp/TestLocalDateTime.scala b/tests/shared/src/test/scala/org/threeten/bp/TestLocalDateTime.scala
index 94890e088..a048e172f 100644
--- a/tests/shared/src/test/scala/org/threeten/bp/TestLocalDateTime.scala
+++ b/tests/shared/src/test/scala/org/threeten/bp/TestLocalDateTime.scala
@@ -1632,7 +1632,7 @@ class TestLocalDateTime
while (i < 50) {
{
t = t.plusHours(1)
- if ((i + 1) % 24 == 0)
+ if ((i + 1) % 24 == 0)
d = d.plusDays(1)
assertEquals(t.toLocalDate, d)
assertEquals(t.getHour, (i + 1) % 24)
@@ -2308,7 +2308,7 @@ class TestLocalDateTime
while (i < 50) {
{
t = t.minusHours(1)
- if (i % 24 == 0)
+ if (i % 24 == 0)
d = d.minusDays(1)
assertEquals(t.toLocalDate, d)
assertEquals(t.getHour, (((-i + 23) % 24) + 24) % 24)
diff --git a/tests/shared/src/test/scala/org/threeten/bp/format/GenTestPrinterParser.scala b/tests/shared/src/test/scala/org/threeten/bp/format/GenTestPrinterParser.scala
index fcca0dfab..20a49c119 100644
--- a/tests/shared/src/test/scala/org/threeten/bp/format/GenTestPrinterParser.scala
+++ b/tests/shared/src/test/scala/org/threeten/bp/format/GenTestPrinterParser.scala
@@ -48,9 +48,9 @@ import org.threeten.bp.format.internal.TTBPDateTimePrintContext
/** Abstract PrinterParser test. */
object GenTestPrinterParser {
private val EMPTY: TemporalAccessor = new TemporalAccessor() {
- def isSupported(field: TemporalField): Boolean = true
- def getLong(field: TemporalField): Long = throw new DateTimeException("Mock")
- override def get(field: TemporalField): Int =
+ def isSupported(field: TemporalField): Boolean = true
+ def getLong(field: TemporalField): Long = throw new DateTimeException("Mock")
+ override def get(field: TemporalField): Int =
range(field).checkValidIntValue(getLong(field), field)
override def query[R](query: TemporalQuery[R]): R = query.queryFrom(this)
override def range(field: TemporalField): ValueRange = field.range
From f2c6dee001b6d1fee9f0c7ac5e6ba20d23facb53 Mon Sep 17 00:00:00 2001
From: Scala Steward