utility: add function for formatting a duration in days + HMS

This commit is contained in:
Joey Castillo
2022-02-06 15:00:58 -05:00
parent 18302bf9c4
commit aae9160422
2 changed files with 25 additions and 0 deletions

View File

@@ -32,6 +32,14 @@
* @brief This section covers various useful functions that don't fit anywhere else.
**/
/// @{
typedef struct {
uint8_t seconds; // 0-59
uint8_t minutes; // 0-59
uint8_t hours; // 0-23
uint32_t days; // 0-4294967295
} watch_duration_t;
/** @brief Returns a two-letter weekday for the given timestamp, suitable for display
* in positions 0-1 of the watch face
* @param date_time The watch_date_time whose weekday you want.
@@ -60,6 +68,12 @@ uint32_t watch_utility_convert_to_unix_time(uint16_t year, uint8_t month, uint8_
*/
uint32_t watch_utility_date_time_to_unix_time(watch_date_time date_time, uint32_t utc_offset);
/** @brief Converts a duration in seconds to a watch_duration_t struct.
* @param seconds A positive number of seconds that you wish to convert to a formatted duration.
* @return A populated struct with the number of days, hours, minutes and seconds elapsed.
*/
watch_duration_t watch_utility_seconds_to_duration(uint32_t seconds);
/** @brief Returns the UNIX time (seconds since 1970) for a given watch_date_time struct.
* @param timestamp The UNIX timestamp that you wish to convert.
* @param utc_offset The number of seconds that you wish date_time to be offset from UTC.