Enhance tests with documentation of properties resulting from parsing

Author: dkhalanskyjb

core/common/test/DateTimePeriodTest.kt

@@ -78,10 +78,12 @@ class DateTimePeriodTest {
         assertEquals(DateTimePeriod(years = 1), DateTimePeriod.parse("P1Y"))
         assertEquals(DatePeriod(years = 1, months = 1), DateTimePeriod.parse("P1Y1M"))
         assertEquals(DateTimePeriod(months = 11), DateTimePeriod.parse("P11M"))
-        assertEquals(DateTimePeriod(months = 14), DateTimePeriod.parse("P14M"))
         assertEquals(DateTimePeriod(months = 10, days = 5), DateTimePeriod.parse("P10M5D"))
         assertEquals(DateTimePeriod(years = 1, days = 40), DateTimePeriod.parse("P1Y40D"))
 
+        assertEquals(DateTimePeriod(months = 14), DateTimePeriod.parse("P14M"))
+        assertPeriodComponents(DateTimePeriod.parse("P14M") as DatePeriod, years = 1, months = 2)
+
         assertEquals(DateTimePeriod(hours = 1), DateTimePeriod.parse("PT1H"))
         assertEquals(DateTimePeriod(), DateTimePeriod.parse("P0D"))
         assertEquals(DatePeriod(), DateTimePeriod.parse("P0D"))
@@ -92,13 +94,19 @@ class DateTimePeriodTest {
 
         assertEquals(DateTimePeriod(years = -1, months = -2, days = -3, hours = -4, minutes = -5, seconds = 0, nanoseconds = 500_000_000),
             DateTimePeriod.parse("P-1Y-2M-3DT-4H-5M0.500000000S"))
+        assertPeriodComponents(DateTimePeriod.parse("P-1Y-2M-3DT-4H-5M0.500000000S"),
+            years = -1, months = -2, days = -3, hours = -4, minutes = -4, seconds = -59, nanoseconds = -500_000_000)
 
         assertEquals(DateTimePeriod(nanoseconds = 999_999_999_999_999L), DateTimePeriod.parse("PT277H46M39.999999999S"))
-        assertEquals(DateTimePeriod(seconds = 1, nanoseconds = -1L), DateTimePeriod.parse("PT0.999999999S"))
-        assertEquals(DateTimePeriod(nanoseconds = -1L), DateTimePeriod.parse("-PT0.000000001S"))
-        assertEquals(DateTimePeriod(days = 1, nanoseconds = -1L), DateTimePeriod.parse("P1DT-0.000000001S"))
-        assertEquals(DateTimePeriod(seconds = -1, nanoseconds = 1L), DateTimePeriod.parse("-PT0.999999999S"))
-        assertEquals(DateTimePeriod(days = 1, seconds = -1, nanoseconds = 1L), DateTimePeriod.parse("P1DT-0.999999999S"))
+        assertPeriodComponents(DateTimePeriod.parse("PT277H46M39.999999999S"),
+            hours = 277, minutes = 46, seconds = 39, nanoseconds = 999_999_999)
+
+        assertEquals(DateTimePeriod(nanoseconds = 999_999_999), DateTimePeriod.parse("PT0.999999999S"))
+        assertEquals(DateTimePeriod(nanoseconds = -1), DateTimePeriod.parse("-PT0.000000001S"))
+        assertEquals(DateTimePeriod(days = 1, nanoseconds = -1), DateTimePeriod.parse("P1DT-0.000000001S"))
+        assertEquals(DateTimePeriod(nanoseconds = -999_999_999), DateTimePeriod.parse("-PT0.999999999S"))
+        assertEquals(DateTimePeriod(days = 1, nanoseconds = -999_999_999), DateTimePeriod.parse("P1DT-0.999999999S"))
+        assertPeriodComponents(DateTimePeriod.parse("P1DT-0.999999999S"), days = 1, nanoseconds = -999_999_999)
 
         // overflow of `Int.MAX_VALUE` months
         assertFailsWith<IllegalArgumentException> { DateTimePeriod.parse("P2000000000Y") }