Welcome! In this lesson, we will delve into the practical applications of string operations and type conversions in TypeScript. By leveraging TypeScript's type safety features, we can write robust code that handles time parsing more reliably. Have you ever wondered how to add a specific number of seconds to a given time? By the end of today's session, you'll be equipped to perform this calculation using TypeScript. 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 number of seconds. Your task is to calculate the new time after adding the provided seconds and 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 our 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 TypeScript, we use the split method to divide the string at ":" and convert each substring into an integer, with type annotations added for clarity:

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:

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:

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, with added type annotations:

• First, we calculate the number of hours in the total seconds: let newHours: number = Math.floor(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: let newMinutes: number = Math.floor(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: let newSeconds: number = totalSeconds;.

So the complete code for this step is:

The final step is to assemble these values into our HH:MM:SS format string. TypeScript allows us to use template literals for formatting:

Here, padStart(2, '0') 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 in TypeScript, utilizing type annotations for parameters and return types:

And there you have it! You've crafted a TypeScript function that accurately calculates the new time based on the provided time and the number of seconds to be added.

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. Following this, you learned how to perform the reverse operation: calculate the time based on the number of seconds that have passed since the beginning of the day. In this lesson, we practiced key TypeScript skills, including type safety, string operations, and type annotations. 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!