summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/pr_now.rst
blob: 5f5efc02035e0facb6a8c71483f6422ac1cb7a62 (plain)
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
36
37
38
PR_Now
======

Returns the current time.


Syntax
------

.. code::

   #include <prtime.h>

   PRTime PR_Now(void);


Parameters
~~~~~~~~~~

None.


Returns
~~~~~~~

The current time as a :ref:`PRTime` value.


Description
-----------

``PR_Now()`` returns the current time as number of microseconds since
the NSPR epoch, which is midnight (00:00:00) 1 January 1970 UTC.

You cannot assume that the values returned by ``PR_Now()`` are
monotonically increasing because the system clock of the computer may be
reset. To obtain monotonically increasing time stamps suitable for
measuring elapsed time, use ``PR_IntervalNow()``.