update: new datetime version (#479)

Author: zamulla

topics/multiplatform-onboard/multiplatform-create-first-app.md

@@ -237,14 +237,6 @@ such as properties and classes. Let's implement an expected property:
    }
    ```
 
-<!-- sample needs to be updated
-
-    > You can find this state of the project in our [GitHub repository](https://github.com/kotlin-hands-on/get-started-with-kmp/tree/main/step2).
-    >
-    {style="tip"}
-
--->
-
 ## Run your application
 
 You can run your multiplatform application for both [Android](#run-your-application-on-android)

topics/multiplatform-onboard/multiplatform-dependencies.md

@@ -49,18 +49,19 @@ function to display the number of days left until New Year's Day. The `kotlinx-d
 multiplatform support, is the most convenient way to work with dates in your shared code.
 
 1. Open the `build.gradle.kts` file located in the `shared` directory.
-2. Add the following dependency to the `commonMain` source set dependencies:
+2. Add the following dependency and the Kotlin time opt-in to the `commonMain` source set dependencies:
 
-   ```kotlin
-   kotlin {
-       //... 
-       sourceSets {
-           commonMain.dependencies {
-               implementation("org.jetbrains.kotlinx:kotlinx-datetime:%dateTimeVersion%")
-           } 
-       }
-   }
-   ```
+    ```kotlin
+    kotlin {
+        //... 
+        sourceSets
+            languageSettings.optIn("kotlin.time.ExperimentalTime")
+            commonMain.dependencies {
+                implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.7.1")
+            } 
+        }
+    }
+    ```
 
 3. Click the **Sync Gradle Changes** button to synchronize Gradle files: ![Synchronize Gradle files](gradle-sync.png){width=50}
 4. In `shared/src/commonMain/kotlin`, create a new file, `NewYear.kt`, in the project directory where your `Greeting.kt` file is located.
@@ -69,6 +70,7 @@ multiplatform support, is the most convenient way to work with dates in your sha
 
    ```kotlin
    import kotlinx.datetime.*
+   import kotlin.time.Clock
 
    fun daysUntilNewYear(): Int {
        val today = Clock.System.todayIn(TimeZone.currentSystemDefault())
@@ -97,14 +99,6 @@ multiplatform support, is the most convenient way to work with dates in your sha
 
 ![Updated mobile multiplatform app with external dependencies](first-multiplatform-project-3.png){width=500}
 
-<!-- sample needs to be updated
-
-    > You can find this state of the project in our [GitHub repository](https://github.com/kotlin-hands-on/get-started-with-kmp/tree/main/step4).
-    >
-    {style="tip"}
-
--->
-
 ## Next step
 
 In the next part of the tutorial, you'll add more dependencies and more complex logic to your project.

topics/multiplatform-onboard/multiplatform-update-ui.md

@@ -33,6 +33,8 @@ Make some changes and see how they are reflected in the UI:
 3. In the `Greeting.kt` file, update the `greet()` function:
 
    ```kotlin
+   import kotlin.random.Random
+   
    fun greet(): List<String> = buildList {
        add(if (Random.nextBoolean()) "Hi!" else "Hello!")
        add("Guess what this is! > ${platform.name.reversed()}!")
@@ -109,14 +111,6 @@ Implement the same changes as in the Android app:
 
     ![Updated UI of your iOS multiplatform app](first-multiplatform-project-on-ios-2.png){width=300}
 
-<!-- sample needs to be updated
-
-> You can find this state of the project in our [GitHub repository](https://github.com/kotlin-hands-on/get-started-with-kmp/tree/main/step3).
->
-{style="tip"}
-
--->
-
 ## Possible issues and solutions
 
 ### Xcode reports errors in the code calling the shared framework

topics/multiplatform-onboard/multiplatform-upgrade-app.md

@@ -220,9 +220,9 @@ data class RocketLaunch (
 6. Convert the launch date from UTC to your local date and format the output:
 
    ```kotlin
-   import kotlinx.datetime.Instant
    import kotlinx.datetime.TimeZone
    import kotlinx.datetime.toLocalDateTime
+   import kotlin.time.Instant
 
    class RocketComponent {
        // ...
@@ -234,7 +234,7 @@ data class RocketLaunch (
            val date = Instant.parse(lastSuccessLaunch.launchDateUTC)
                .toLocalDateTime(TimeZone.currentSystemDefault())
 
-           return "${date.month} ${date.dayOfMonth}, ${date.year}" 
+           return "${date.month} ${date.day}, ${date.year}"
        }
    }
    ```
@@ -554,7 +554,10 @@ wrappers.
         // ...
         sourceSets{
             all {
-                languageSettings.optIn("kotlin.experimental.ExperimentalObjCName")
+                languageSettings {
+                    optIn("kotlin.experimental.ExperimentalObjCName")
+                    optIn("kotlin.time.ExperimentalTime")
+                }
             }
             // ...
         }