Time Sync Card

This feature is only available in ESP-DASH Pro

A utility card for synchronizing device time with the MCU using browser time data.

Initializer

To create a time sync card in ESP-DASH v5, use the dash::TimeSyncCard class.

dash::TimeSyncCard timesync(dashboard, "Time Sync");

Callback

You can register a callback to handle time sync events:

timesync.onSync([](const timeval& tv) {
  Serial.printf("Time Sync: %ld\n", tv.tv_sec);
});

Methods

setTimezoneSpec

Set the timezone specification string (IANA TZ or POSIX format) for the time sync card. This is optional, but allows you to control the timezone used for synchronization.

timesync.setTimezoneSpec("CET-1CEST,M3.5.0,M10.5.0/3");

• Signature: void setTimezoneSpec(const char* tzSpec)
• Parameters:
  • const char* tzSpec — The timezone specification string.
• Returns: void

timezoneSpec

Get the current timezone specification string.

const char* tz = timesync.timezoneSpec();

• Signature: const char* timezoneSpec()
• Parameters: None
• Returns: const char* — The current timezone specification string.

Reference

dash::TimeSyncCard timesync(dashboard, "Time Sync");
 
void setup() {
  // ...
 
  timesync.onSync([](const timeval& tv) {
    Serial.printf("Time Sync: %ld\n", tv.tv_sec);
    // Set system time, etc.
  });
  
  // Optionally set timezone
  timesync.setTimezoneSpec("CET-1CEST,M3.5.0,M10.5.0/3");
}
 
void loop() {
  // No periodic update needed; callback handles sync
}