Returns the time (in milliseconds) at which the event was created.

Note: This property only works if the event system supports it for the particular event.

Syntax

event.timeStamp

Value

This value is the number of milliseconds elapsed from the beginning of the current document's lifetime till the event was created.

In newer implementations, the value is a DOMHighResTimeStamp  accurate to 5 microseconds (0.005 ms). In older implementations, the value is a DOMTimeStamp, accurate to a millisecond.

Example

HTML content

<p>
  Focus this iframe and press any key to get the
  current timestamp for the keypress event.
</p>
<p>timeStamp: <span id="time">-</span></p>

JavaScript content

function getTime(event) {
  var time = document.getElementById("time");
  time.firstChild.nodeValue = event.timeStamp;
}
document.body.addEventListener("keypress", getTime);

Result

Specifications

Specification Status Comment
DOM
The definition of 'Event.timeStamp' in that specification.
Living Standard  
DOM4
The definition of 'Event.timeStamp' in that specification.
Obsolete  
Document Object Model (DOM) Level 2 Events Specification
The definition of 'Event.timeStamp' in that specification.
Obsolete Initial definition

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 49.0[1] (Yes) (Yes)[1] (Yes) (Yes) ?
Feature Android Android Webview Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support 49.0[1] (Yes) (Yes)[1] ? ? ? 49.0

[1] Starting with Chrome 49 and Firefox 54, this property returns a high-resolution monotonic time (DOMHighResTimeStamp) instead of epoch time (DOMTimeStamp).

Document Tags and Contributors

 Last updated by: spicyj,