Contact Us

    If you still have questions or prefer to get help directly from an agent, please submit a request.
    We’ll get back to you as soon as possible.

    Please fill out the contact form below and we will reply as soon as possible.

    • Digital Matter Site
    • Contact Us

    Times in the DM Protocol

    Written by Matthew Clark-Massera

    Updated at September 14th, 2023

      Contact Us

      If you still have questions or prefer to get help directly from an agent, please submit a request.
      We’ll get back to you as soon as possible.

      Contact Support
      • Home
      • Device Manager
      • Integration

      Table of Contents

      Format Multiple Times Online Calculator

      This article gives some useful information about how times are sent in the Digital Matter cellular device protocol.

      For more detail on the protocol, request the integration documents from your local Digital Matter support contact.

      Format

      Times are sent as a count in seconds since midnight (00:00:00) 1 January 2013. This can be considered the Digital Matter Epoch.

      All times are sent as UTC times.

      In MS SQL, Integrators could convert the second count to a meaningful time with this statement, where 131798667 is the second count to convert:

      select DATEADD(second, 131798667, '2013-01-01')

      or, go the other way with:

      select DATEADD(second, '2013-01-01', '2017-03-06 10:44:27')

      Multiple Times 

      Integrators will often need to handle 3 times:

      1. Record time: this is the time that the record was logged. It can be found in the device data record header. It is in UTC time, as a count in seconds since midnight (00:00:00) 1 January 2013.
      2. GPS field time: this is the time that the GPS fix was obtained. This is may be older than the record time, if an old fix was used in the logging of the record. It is in UTC time, as a count in seconds since midnight (00:00:00) 1 January 2013. If a valid fix has not been obtained since a power on reset, the time will be zero (2013-01-01 00:00:00).
      3. Received time: this can useful for the platform to record. It is not sent by the device. It would be the time at which the platform received the record. This can be useful to understand the transmission delay.

      Online Calculator

      You can convert to and from the device protocol's timestamp format with the embedded calculator below:

      DM Timestamp Decoder

      dming timeframes dm seconds dm time digital matter time digital matter seconds time protocol

      Was this article helpful?

      Yes
      No
      Give feedback about this article

      Related Articles

      • The HTTP/HTTPS Connector
      • Decode Cellular Uplink Payload using your Browser
      • Device Manager - What IP addresses should I allow through my firewall?
      • Choosing an Integration Strategy

      Subscribe to Partner News

      Subscribe to our mailing list to receive Digital Matter news, product and tehnical updates, and more.

      Subscribe

      Copyright © Digital Matter . All Rights Reserved.

      Privacy Contact Support

      Knowledge Base Software powered by Helpjuice

      DM Logo
      Expand