Add remaining docs for Duration members, runnable samples for toString

libraries/stdlib/samples/build.gradle

@@ -13,7 +13,9 @@ compileTestKotlin {
     kotlinOptions {
         jdkHome = JDK_18
         freeCompilerArgs = [
-                "-Xuse-experimental=kotlin.ExperimentalUnsignedTypes"
+                "-Xuse-experimental=kotlin.ExperimentalStdlibApi",
+                "-Xuse-experimental=kotlin.ExperimentalUnsignedTypes",
+                "-Xuse-experimental=kotlin.time.ExperimentalTime"
         ]
     }
 }

libraries/stdlib/samples/test/samples/time/durations.kt

@@ -0,0 +1,46 @@
+/*
+ * Copyright 2010-2019 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
+ */
+
+package samples.time
+
+import samples.*
+
+import kotlin.time.*
+
+class Durations {
+
+    @Sample
+    fun toIsoString() {
+        assertPrints(25.nanoseconds.toIsoString(), "PT0.000000025S")
+        assertPrints(120.3.milliseconds.toIsoString(), "PT0.120300S")
+        assertPrints(30.5.seconds.toIsoString(), "PT30.500S")
+        assertPrints(30.5.minutes.toIsoString(), "PT30M30S")
+        assertPrints(86420.seconds.toIsoString(), "PT24H0M20S")
+        assertPrints(2.days.toIsoString(), "PT48H")
+        assertPrints(Duration.ZERO.toIsoString(), "PT0S")
+        assertPrints(Duration.INFINITE.toIsoString(), "PT2147483647H")
+    }
+
+    @Sample
+    fun toStringDefault() {
+        assertPrints(45.days, "45.0d")
+        assertPrints(1.5.days, "36.0h")
+        assertPrints(1230.minutes, "20.5h")
+        assertPrints(920.minutes, "920m")
+        assertPrints(1.546.seconds, "1.55s")
+        assertPrints(25.12.milliseconds, "25.1ms")
+    }
+
+    @Sample
+    fun toStringDecimals() {
+        assertPrints(1230.minutes.toString(DurationUnit.DAYS, 2), "0.85d")
+        assertPrints(1230.minutes.toString(DurationUnit.HOURS, 2), "20.50h")
+        assertPrints(1230.minutes.toString(DurationUnit.MINUTES), "1230m")
+        assertPrints(1230.minutes.toString(DurationUnit.SECONDS), "73800s")
+    }
+
+
+
+}