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

@ -151,6 +151,17 @@ watch_date_time watch_utility_date_time_convert_zone(watch_date_time date_time,
return watch_utility_date_time_from_unix_time(timestamp, destination_utc_offset);
}
watch_duration_t watch_utility_seconds_to_duration(uint32_t seconds) {
watch_duration_t retval;
retval.seconds = (seconds % 60);
retval.minutes = (seconds % 3600) / 60;
retval.hours = (seconds % 86400) / 3600;
retval.days = seconds / 86400;
return retval;
}
bool watch_utility_convert_to_12_hour(watch_date_time *date_time) {
bool is_pm = date_time->unit.hour > 11;
date_time->unit.hour %= 12;

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.