Skip to content
CC2 Device Documentation

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,
  },
}

uptimeSecs

Section titled “uptimeSecs”

Device uptime in seconds.

Configuration variables

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

deltaSecs

Section titled “deltaSecs”

Current offset in seconds between device uptime and UTC.

Configuration variables

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

UTCSecs

Section titled “UTCSecs”

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

Configuration variables

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

timestr

Section titled “timestr”

Current local time as a formatted string.

Configuration variables

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

datestr

Section titled “datestr”

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",
    },
  },
}

usdatestr

Section titled “usdatestr”

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

Configuration variables

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

iso8601

Section titled “iso8601”

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",
    },
  },
}
Section titled “Related”