Welcome! In this lesson, we will explore the practical applications of string operations and type conversions using Kotlin. These concepts are essential and are utilized in numerous programming scenarios. We'll focus on a real-world example: time parsing. Have you ever wondered how to add a certain number of seconds to a specific time? By the end of today's session, you'll have the ability to calculate this using Kotlin. Let's get started!

Imagine this: You receive a time formatted as a string in HH:MM:SS, where HH, MM, and SS denote the hour, minute, and second, respectively. You are also given an integer representing a certain number of seconds. Your task is to calculate the new time after adding the provided seconds, then output the result in the HH:MM:SS format.

For example, if the input time is 05:10:30 and the number of seconds to add is 123, the output should be 05:12:33 since 123 seconds translate to 2 minutes and 3 seconds.

Please note these points when resolving this task:

• The input time is always a valid time string in the HH:MM:SS format, with HH ranging from 00 to 23 and MM and SS ranging from 00 to 59.
• The output should be a time in the same format.

Now let's go ahead and break down how to achieve this in a step-by-step solution guide.

Our first step involves parsing the input time string. We aim to extract the hours, minutes, and seconds from this string as integer values for further calculations. In Kotlin, we can use the split method to divide the string at ":" and convert each substring into an integer:

Kotlin
Copy to clipboard
1val time = "12:34:56"
2val secondsToAdd = 10
3val timeParts = time.split(":")
4val hours = timeParts[0].toInt()
5val minutes = timeParts[1].toInt()
6val seconds = timeParts[2].toInt()

By executing this operation, we've successfully parsed the time string and converted the hours, minutes, and seconds into integers.

Now that we have the hours, minutes, and seconds in integer format, we can efficiently calculate the total number of seconds that have elapsed since the start of the day:

Kotlin
Copy to clipboard
1val secondsSinceStart = hours * 3600 + minutes * 60 + seconds

At this point, your function should compute the cumulative number of seconds from the start of the day.

Now we need to add the integer representing the number of seconds to our computed secondsSinceStart and also consider cases where the added seconds roll over into the next day:

Kotlin
Copy to clipboard
1val totalSeconds = (secondsSinceStart + secondsToAdd) % (24 * 3600)

The modulus operator % ensures that our totalSeconds value doesn't exceed the total number of seconds in a day (86400 seconds or 24 * 3600 seconds).

In this step, we reverse the previous operation. We're given an integer number of seconds, and we have to convert this into a time string in the HH:MM:SS format.

We will use the division / and modulo % operations directly to convert these values:

• First, we calculate the number of hours in the total seconds: val newHours = totalSeconds / 3600. Here, 3600 is the number of seconds in an hour.
• Next, we update the totalSeconds to the remainder after extracting the hours: totalSeconds %= 3600. This step ensures that totalSeconds now holds the seconds remaining after accounting for hours.

Now, we repeat this process for minutes:

• We calculate the number of minutes in the updated totalSeconds: val newMinutes = totalSeconds / 60. Here, 60 is the number of seconds in a minute.
• Following a similar pattern, update the totalSeconds to the remainder after extracting minutes: totalSeconds %= 60. This step ensures that totalSeconds contains only the seconds remaining after accounting for both hours and minutes.

Finally:

• The remaining totalSeconds directly gives us the seconds: val newSeconds = totalSeconds % 60.

So the complete code for this step is:

Kotlin
Copy to clipboard
1val newHours = totalSeconds / 3600
2totalSeconds %= 3600
3val newMinutes = totalSeconds / 60
4val newSeconds = totalSeconds % 60

The final step is to assemble these values into our HH:MM:SS format string. Kotlin provides template strings for easily formatting results:

Kotlin
Copy to clipboard
1val result = "%02d:%02d:%02d".format(newHours, newMinutes, newSeconds)

Here, %02d ensures that each time unit (hours, minutes, and seconds) will be at least 2 characters wide, padding with 0 if necessary.

Let's collate all the individual steps and formulate the final function:

Kotlin
Copy to clipboard
1fun addSeconds(time: String, secondsToAdd: Int): String {
2    val timeParts = time.split(":")
3    val hours = timeParts[0].toInt()
4    val minutes = timeParts[1].toInt()
5    val seconds = timeParts[2].toInt()
6
7    val secondsSinceStart = hours * 3600 + minutes * 60 + seconds
8    var totalSeconds = (secondsSinceStart + secondsToAdd) % (24 * 3600)
9
10    val newHours = totalSeconds / 3600
11    totalSeconds %= 3600
12    val newMinutes = totalSeconds / 60
13    val newSeconds = totalSeconds % 60
14
15    return "%02d:%02d:%02d".format(newHours, newMinutes, newSeconds)
16}
17
18fun main() {
19    println(addSeconds("05:10:30", 123)) // Expected output: 05:12:33
20}

And there you go! You've crafted a function that accurately calculates the new time based on the provided time and the number of seconds that have elapsed since then.

Congratulations! You have successfully learned how to parse a time string and utilize type conversions to calculate the number of seconds elapsed from the beginning of the day using Kotlin. Following this, you learned how to perform the reverse operation: to calculate the time based on the number of seconds that have passed since the beginning of the day. In this lesson, we practiced essential Kotlin skills, including string handling and arithmetic operations. Continue practicing with similar problems to reinforce your learning, and these tasks will soon become second nature. See you in our next session, and happy coding!