More part methods

Author: cquiroz

core/shared/src/main/scala/org/threeten/bp/Duration.scala

@@ -43,6 +43,7 @@ import org.threeten.bp.LocalTime.SECONDS_PER_DAY
 import org.threeten.bp.LocalTime.SECONDS_PER_HOUR
 import org.threeten.bp.LocalTime.SECONDS_PER_MINUTE
 import org.threeten.bp.LocalTime.HOURS_PER_DAY
+import org.threeten.bp.LocalTime.MINUTES_PER_HOUR
 import org.threeten.bp.format.DateTimeParseException
 import org.threeten.bp.temporal.ChronoField.NANO_OF_SECOND
 import org.threeten.bp.temporal.ChronoUnit
@@ -971,6 +972,20 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
    */
   def toSeconds: Long = seconds
 
+  /**
+   * Extracts the number of seconds part in the duration.
+   *
+   * This returns the remaining seconds when dividing toSeconds() by seconds in a minute. This is
+   * based on the standard definition of a minute as 60 seconds.
+   *
+   * This instance is immutable and unaffected by this method call.
+   *
+   * @return
+   *   the number of seconds parts in the duration, may be negative
+   * @since 9
+   */
+  def toSecondsPart: Int = (toSeconds / SECONDS_PER_MINUTE).toInt
+
   /**
    * Returns a copy of this duration with the length negated.
    *
@@ -1134,6 +1149,20 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
    */
   def toMinutes: Long = seconds / SECONDS_PER_MINUTE
 
+  /**
+   * Extracts the number of minutes part in the duration.
+   *
+   * This returns the number of remaining minutes when dividing toMinutes() by minutes in an hour.
+   * This is based on the standard definition of an hour as 60 minutes.
+   *
+   * This instance is immutable and unaffected by this method call.
+   *
+   * @return
+   *   the number of minutes parts in the duration, may be negative
+   * @since 9
+   */
+  def toMinutesPart: Int = (toMinutes / MINUTES_PER_HOUR).toInt
+
   /**
    * Converts this duration to the total length in milliseconds.
    *
@@ -1154,6 +1183,22 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
     Math.addExact(result, nanos.toLong / Duration.NANOS_PER_MILLI)
   }
 
+  /**
+   * Extracts the number of milliseconds part of the duration.
+   *
+   * This returns the milliseconds part by dividing the number of nanoseconds by 1,000,000. 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 getNano() and getSeconds().
+   *
+   * This instance is immutable and unaffected by this method call.
+   *
+   * @return
+   *   the number of milliseconds part of the duration.
+   * @since 9
+   */
+  def toMillisPart: Int = (nanos / Duration.NANOS_PER_MILLI).toInt
+
   /**
    * Converts this duration to the total length in nanoseconds expressed as a {@code long}.
    *
@@ -1170,6 +1215,21 @@ final class Duration private (private val seconds: Long, private val nanos: Int)
     Math.addExact(result, nanos.toLong)
   }
 
+  /**
+   * Get the nanoseconds part within seconds of the duration.
+   *
+   * 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 getNano() and getSeconds().
+   *
+   * This instance is immutable and unaffected by this method call.
+   *
+   * @return
+   *   the nanoseconds within the second part of the length of the duration, from 0 to 999,999,999
+   * @since 9
+   */
+  def toNanosPart: Int = (nanos / Duration.NANOS_PER_SECOND).toInt
+
   /**
    * Compares this duration to the specified {@code Duration}.
    *

tests/shared/src/test/scala/org/threeten/bp/TestDuration.scala

@@ -37,7 +37,8 @@ import org.threeten.bp.temporal.TemporalUnit
 import org.threeten.bp.LocalTime.SECONDS_PER_DAY
 import org.threeten.bp.LocalTime.HOURS_PER_DAY
 import org.threeten.bp.LocalTime.SECONDS_PER_HOUR
-// import org.threeten.bp.LocalTime.SECONDS_PER_MINUTE
+import org.threeten.bp.LocalTime.MINUTES_PER_HOUR
+import org.threeten.bp.LocalTime.SECONDS_PER_MINUTE
 
 /** Test Duration. */
 class TestDuration extends AnyFunSuite with AssertionsHelper {
@@ -182,6 +183,7 @@ class TestDuration extends AnyFunSuite with AssertionsHelper {
     assertEquals(test.toDaysPart, test.toSeconds / SECONDS_PER_DAY)
     assertEquals(test.toHours, test.toSeconds / SECONDS_PER_HOUR)
     assertEquals(test.toHoursPart, test.toHours / HOURS_PER_DAY)
+    assertEquals(test.toMinutesPart, test.toMinutes / MINUTES_PER_HOUR)
     assertEquals(test.getNano, 999999999)
   }
 
@@ -191,6 +193,8 @@ class TestDuration extends AnyFunSuite with AssertionsHelper {
     assertEquals(test.toSeconds, Long.MaxValue / 1000000000)
     assertEquals(test.toDays, test.toSeconds / SECONDS_PER_DAY)
     assertEquals(test.toDaysPart, test.toSeconds / SECONDS_PER_DAY)
+    assertEquals(test.toMinutesPart, test.toMinutes / MINUTES_PER_HOUR)
+    assertEquals(test.toSecondsPart, test.toSeconds / SECONDS_PER_MINUTE)
     assertEquals(test.getNano, Long.MaxValue % 1000000000)
   }
 
@@ -200,6 +204,7 @@ class TestDuration extends AnyFunSuite with AssertionsHelper {
     assertEquals(test.toSeconds, Long.MinValue / 1000000000 - 1)
     assertEquals(test.toDays, test.toSeconds / SECONDS_PER_DAY)
     assertEquals(test.toDaysPart, test.toSeconds / SECONDS_PER_DAY)
+    assertEquals(test.toMinutesPart, test.toMinutes / MINUTES_PER_HOUR)
     assertEquals(test.getNano, Long.MinValue % 1000000000 + 1000000000)
   }
 
@@ -1914,11 +1919,13 @@ class TestDuration extends AnyFunSuite with AssertionsHelper {
   test("test_toNanos") {
     val test: Duration = Duration.ofSeconds(321, 123456789)
     assertEquals(test.toNanos, 321123456789L)
+    assertEquals(test.toNanosPart, 0L)
   }
 
   test("test_toNanos_max") {
     val test: Duration = Duration.ofSeconds(0, Long.MaxValue)
     assertEquals(test.toNanos, Long.MaxValue)
+    assertEquals(test.toNanosPart, 0L)
   }
 
   test("test_toNanos_tooBig") {
@@ -1931,11 +1938,13 @@ class TestDuration extends AnyFunSuite with AssertionsHelper {
   test("test_toMillis") {
     val test: Duration = Duration.ofSeconds(321, 123456789)
     assertEquals(test.toMillis, 321000 + 123)
+    assertEquals(test.toMillisPart, 123)
   }
 
   test("test_toMillis_max") {
     val test: Duration = Duration.ofSeconds(Long.MaxValue / 1000, (Long.MaxValue % 1000) * 1000000)
     assertEquals(test.toMillis, Long.MaxValue)
+    assertEquals(test.toMillisPart, 807)
   }
 
   test("test_toMillis_tooBig") {