Skip to content

Time Uplink Data

Once the device clock has been synchronised (via devcfg.time), it reports the current UTC time, local time strings, and the offset from its internal uptime.

Key path: devdata.time

To request current values:

{ "devdata": { "time": null } }

Device uptime in seconds.

Configuration variables

  • Type: integer
  • Sent on: Periodic, on request
{ "devdata": { "time": { "uptimeSecs": 123456 } } }

Current offset in seconds between device uptime and UTC.

Configuration variables

  • Type: integer
  • Sent on: After time sync, on request
{ "devdata": { "time": { "deltaSecs": 3600 } } }

Current UTC time as a Unix timestamp (seconds since epoch).

Configuration variables

  • Type: integer
  • Sent on: Periodic, on request
{ "devdata": { "time": { "UTCSecs": 1718100000 } } }

Current local time as a formatted string.

Configuration variables

  • Type: string
  • Sent on: Periodic, on request
{ "devdata": { "time": { "timestr": "14:30:00" } } }

Current date in local format (DD/MM/YY or similar).

Configuration variables

  • Type: string
  • Sent on: Periodic, on request
{ "devdata": { "time": { "datestr": "10/06/24" } } }

Current date in US format (MM/DD/YY).

Configuration variables

  • Type: string
  • Sent on: Periodic, on request
{ "devdata": { "time": { "usdatestr": "06/10/24" } } }

Current date and time as an ISO 8601 string.

Configuration variables

  • Type: string
  • Sent on: Periodic, on request
{ "devdata": { "time": { "iso8601": "2024-06-10T14:30:00Z" } } }