GPS History Blocks - {{formatDate }} handlebar templates


Hi guys,

I’m using the {{formatDate }} handlebar template to add content to the pin popup boxes. I’d like to have some control over the date display format, especially with respect to timezone and locale. Is there documentation for {{formatDate}}?





Here’s the overall docs for our helpers:

The formatDate helper specifically uses the Moment.js format, which is documented here:

So for for example, if you wanted the result to be 2018-05-23, you’d use the format:

{{ formatDate time 'YYYY-MM-DD' }}


Thanks Brandon,

The docs were helpful. But now I find that my problem is not formatting, it’s timezone. {{formatDate }} seems to use UTC as its timezone. The value being fed to formatDate is encoded as an ISO 8601 string with an offset from UTC. formatDate simply renders the date as local time for UTC, which is completely wrong. I need to be able to specify the timezone and then render as local time.

Ideally the timezone could be inferred from the lat-long pin location. You could use something like

Any ideas how I can specify timezone?



It does not look like {{formatDate}} will allow you to render it with a specific timezone. The helpers are rendered by the browser, so they always appear local to whoever is looking at the dashboard. If I understand correctly, you’d like to show it rendered local to the timezone were the asset is physically located.

A workaround would be to use a workflow to add a string attribute to the device with the time formatted in whatever way you’d like. Workflows provide a lot more power to manipulate data.

I believe you can copy/paste all of moment.js into a function node and then use it.

var date = moment(payload.time);"-04:00") = date.format("...");

The workflow would trigger on device state, run the function node, and then use a Device State node to record the new formattedDate attribute on the same timestamp as the GPS.

It’s very important to understand that reporting state in a workflow that’s triggered on state will cause an infinite loop that we will detect and kill. You need to add a Conditional node after the trigger to check that your GPS coordinate is on the payload and that’s what triggered it.



Thanks for the workaround tip. I’d really like to avoid manipulating a date attribute purely for a view. To me localization is a presentation issue not a data issue.

FYI we’re based in NZ. We have some historic time data stored as strings in a Losant data table. Originally this was written in local time, ie. without any time zone information. We’ve since corrected this data to include a 12 hour offset and will be recording future dates in UTC.

We process these data table’s in a Losant workflow and use the dates to populate a device attribute. These attributes are encoded as a string in ISO 8601 UTC format. When we inspect these dates in the GPS map the results are out by 12 hours, ie. they are displayed at Z time. In other words, the browser’s locale is not taken into account.

But as I said, we’d much prefer the time zone to be inferred from the pin location. If I were to review data of a device located in Paris from a computer in NZ I’d like to know the local Paris time of the attribute or the UTC time of the attribute. But I wouldn’t want to know the NZ local time of the attribute. In other words, browser locale is unlikely to be correct in the general case.