[CB-4596] Documentation is not consistent for timestamp types

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.9.0
• Component/s: cordova-plugin-device-motion (DEPRECATED), cordova-plugin-device-orientation (DEPRECATED), cordova-plugin-geolocation
• Assignee: Jesse MacFadyen
• Reporter: Peter
• Created: 15/Aug/13 23:26
• Updated: 23/Aug/18 06:45
• Resolved: 28/Oct/15 00:44

Description

Compare Codova documentation for these timestamps:

• Accelerometer > Acceleration.timestamp - timestamp: Creation timestamp in milliseconds. (DOMTimeStamp)
• Compass > CompassHeading.timestamp - timestamp: The time at which this heading was determined. (milliseconds)
• Geolocation > Position.timestamp - timestamp: Creation timestamp for coords. (Date)

It is confusing that documentation describes all these "timestamps" to have different types.

On closer inspection, for some reason the Position.timestamp really is (inconsistent with the others) returned as a Date object.

But at least Acceleration/Compass ones seem to have same units so perhaps the documentation for those ones ought to consistently say they are DOMTimeStamp.
Ref http://dev.w3.org/2006/webapi/WebIDL/#common-DOMTimeStamp