PicoTime Class Reference

Cross-platform time utilities for RP2040 and RP2350. More...

#include <PicoTime.h>

Collaboration diagram for PicoTime:

Static Public Member Functions
static time_t	now ()
	Get the current epoch time using platform RTC or AON.
static struct tm	nowTm ()
	Get the current local time as struct tm.
static std::string	getNowHhMmSs ()
	Get the current time as a datetime_t.
static struct tm	todayAt (const struct tm *hhmmss)
	Construct today's date with a specific time-of-day.
static time_t	todayAtTimeT (const struct tm *hhmmss)
	Convert a tm with today's date and time to epoch.
static std::string	todayHhMmSsString (const struct tm *hhmmss)
	Convert a time-of-day to a string for today.
static void	printNow ()
	Print the current time to stdout.
static void	print (time_t t)
	Print a given UNIX timestamp to stdout.
static void	print (const struct tm *t)
	Print a struct tm to stdout.
static TimeOfDay	toTimeOfDay (uint32_t timestamp)
	Print a datetime_t to stdout.
static DaysOfWeek	dayOfWeekBitmask (uint32_t timestamp)
static Day	dayOfWeek (uint32_t timestamp)
static std::string	formatIso8601 (time_t t)

Detailed Description

Definition at line 34 of file PicoTime.h.

Member Function Documentation

dayOfWeek()

static Day PicoTime::dayOfWeek ( uint32_t  timestamp )

inlinestatic

Definition at line 122 of file PicoTime.h.

                                             {
        uint32_t days = timestamp / 86400;
        uint8_t weekday = (days + 4) % 7;  // Sunday = 0
        return static_cast<Day>(1u << weekday);
    }

dayOfWeekBitmask()

static DaysOfWeek PicoTime::dayOfWeekBitmask ( uint32_t  timestamp )

inlinestatic

Definition at line 116 of file PicoTime.h.

                                                           {
        uint32_t days = timestamp / 86400;
        uint8_t weekday = (days + 4) % 7;  // Sunday = 0
        return static_cast<DaysOfWeek>(1u << weekday);
    }  

formatIso8601()

std::string PicoTime::formatIso8601 ( time_t  t )

static

Definition at line 131 of file PicoTime.cpp.

{
    struct tm tm;
    localtime_r(&t, &tm);
    char buf[32];
    strftime(buf, sizeof(buf), "%Y-%m-%dT%H:%M:%S", &tm);
    return std::string(buf);
}

getNowHhMmSs()

std::string PicoTime::getNowHhMmSs ( )

static

Returns

Time in datetime_t format.

Get a string with the current time formatted as HH:MM:SS.

Returns

Formatted time string.

Get the current time as a datetime_t.

Returns

Time in datetime_t format.

Get a string with the current time formatted as HH:MM:SS.

Returns

Formatted time string.

Definition at line 69 of file PicoTime.cpp.

{
    struct tm t = nowTm();
    char buf[9];
    snprintf(buf, sizeof(buf), "%02d:%02d:%02d", t.tm_hour, t.tm_min, t.tm_sec);
    return std::string(buf);
}

References nowTm().

Here is the call graph for this function:

now()

time_t PicoTime::now ( )

static

Get the current epoch time using platform RTC or AON.

Returns

Current UNIX timestamp.

Returns

Current UNIX timestamp.

Definition at line 28 of file PicoTime.cpp.

{
#if defined(PICO_RP2040)
    datetime_t dt;
    rtc_get_datetime(&dt);
    struct tm t = {};
    t.tm_year = dt.year - 1900;
    t.tm_mon = dt.month - 1;
    t.tm_mday = dt.day;
    t.tm_hour = dt.hour;
    t.tm_min = dt.min;
    t.tm_sec = dt.sec;
    return mktime(&t);
#elif defined(PICO_RP2350)
    // Use AON timer for RP2350
    timespec t;
    aon_timer_get_time(&t);
    return t.tv_sec; // Return seconds since epoch
#endif    
}    

Referenced by TimeManager::currentTimeForTrace(), TimeManager::formatTimeWithZone(), Logger::getTimeString(), printNow(), TimerService::scheduleAt(), TimerService::scheduleCallbackAt(), TimerService::scheduleDailyAt(), and TimerService::scheduleDuration().

Here is the caller graph for this function:

nowTm()

struct tm PicoTime::nowTm ( )

static

Get the current local time as struct tm.

Returns

Current time in tm format.

Returns

Current time in tm format.

Definition at line 50 of file PicoTime.cpp.

{
    time_t t = now();
    struct tm out;
    localtime_r(&t, &out);
    return out;
}

Referenced by getNowHhMmSs().

Here is the caller graph for this function:

print() [1/2]

void PicoTime::print ( const struct tm *  t )

static

Print a struct tm to stdout.

Parameters

t	Pointer to tm to print.

Parameters

t	Pointer to tm to print.

Definition at line 124 of file PicoTime.cpp.

{
    char buf[32];
    strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", t);
    printf("%s\n", buf);
}

print() [2/2]

void PicoTime::print ( time_t  t )

static

Print a given UNIX timestamp to stdout.

Parameters

t	UNIX time value.

Parameters

t	UNIX time value.

Definition at line 116 of file PicoTime.cpp.

{
    struct tm tm;
    localtime_r(&t, &tm);
    print(&tm);
}

References print().

Referenced by print(), and printNow().

Here is the call graph for this function:

Here is the caller graph for this function:

printNow()

void PicoTime::printNow ( )

static

Print the current time to stdout.

Definition at line 110 of file PicoTime.cpp.

{
    print(now());
}

References now(), and print().

Here is the call graph for this function:

todayAt()

struct tm PicoTime::todayAt ( const struct tm *  hhmmss )

static

Construct today's date with a specific time-of-day.

Parameters

hhmmss

Pointer to a tm with hour/min/sec set.

Returns

Combined tm with today's date and given time.

Parameters

hhmmss

Pointer to a tm with hour/min/sec set.

Returns

Combined tm with today's date and given time.

Definition at line 78 of file PicoTime.cpp.

{
    struct tm now = nowTm();
    struct tm result = {
        .tm_sec = hhmmss->tm_sec,
        .tm_min = hhmmss->tm_min,
        .tm_hour = hhmmss->tm_hour,
        .tm_mday = now.tm_mday,
        .tm_mon = now.tm_mon,
        .tm_year = now.tm_year,
        .tm_isdst = -1};
    mktime(&result); // Normalize
    return result;
}

Referenced by todayAtTimeT(), and todayHhMmSsString().

Here is the caller graph for this function:

todayAtTimeT()

time_t PicoTime::todayAtTimeT ( const struct tm *  hhmmss )

static

Convert a tm with today's date and time to epoch.

Parameters

hhmmss

Pointer to tm with time-of-day.

Returns

Time as UNIX timestamp.

Parameters

hhmmss

Pointer to tm with time-of-day.

Returns

Time as UNIX timestamp.

Definition at line 94 of file PicoTime.cpp.

{
    struct tm t = todayAt(hhmmss);
    return mktime(&t);
}

References todayAt().

Here is the call graph for this function:

todayHhMmSsString()

std::string PicoTime::todayHhMmSsString ( const struct tm *  hhmmss )

static

Convert a time-of-day to a string for today.

Parameters

hhmmss

Pointer to tm with hour/min/sec.

Returns

Formatted string including date and time.

Parameters

hhmmss

Pointer to tm with hour/min/sec.

Returns

Formatted string including date and time.

Definition at line 101 of file PicoTime.cpp.

{
    struct tm t = todayAt(hhmmss);
    char buf[32];
    strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", &t);
    return std::string(buf);
}

References todayAt().

Here is the call graph for this function:

toTimeOfDay()

static TimeOfDay PicoTime::toTimeOfDay ( uint32_t  timestamp )

inlinestatic

Parameters

dt	Pointer to datetime_t to print.

Definition at line 109 of file PicoTime.h.

                                                     {
        time_t t = static_cast<time_t>(timestamp);
        struct tm tm;
        localtime_r(&t, &tm);
        return TimeOfDay{ static_cast<uint8_t>(tm.tm_hour), static_cast<uint8_t>(tm.tm_min), static_cast<uint8_t>(tm.tm_sec) };
    }

---

The documentation for this class was generated from the following files:

• PicoTime.h
• PicoTime.cpp