event.timeStamp | jQuery API Documentation

event.timeStamp

Categories: Events > Event Object

event.timeStampReturns: Number

Description: The difference in milliseconds between the time the browser created the event and January 1, 1970.

  • version added: 1.2.6event.timeStamp

This property can be useful for profiling event performance by getting the event.timeStamp value at two points in the code and noting the difference. To simply determine the current time inside an event handler, use (new Date).getTime() instead.

Note: Due to a bug open since 2004<, this value is not populated correctly in Firefox and it is not possible to know the time the event was created in that browser.

Example:

Display the time since the click handler last executed.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>event.timeStamp demo</title>
  <style>
  div {
    height: 100px;
    width: 300px;
    margin: 10px;
    background-color: #ffd;
    overflow: auto;
  }
  </style>
  <script src="https://code.jquery.com/jquery-3.7.1.js"></script>
</head>
<body>
 
<div>Click.</div>
 
<script>
var last, diff;
$( "div" ).on( "click", function( event ) {
  if ( last ) {
    diff = event.timeStamp - last;
    $( "div" ).append( "time since last event: " + diff + "<br>" );
  } else {
    $( "div" ).append( "Click again.<br>" );
  }
  last = event.timeStamp;
});
</script>
 
</body>
</html>

Demo: