aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/micros.rst
blob: 711c0135103be63a15513d8d44cc924b65d87467 (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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
.. _lang-micros:

micros()
========

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

Returns the number of microseconds since the Arduino board began
running the current program. This number will overflow (go back to
zero), after approximately 70 minutes. On 16 MHz Arduino boards
(e.g. Duemilanove and Nano), this function has a resolution of four
microseconds (i.e. the value returned is always a multiple of
four). On 8 MHz Arduino boards (e.g. the LilyPad), this function
has a resolution of eight microseconds.



*Note*: there are 1,000 microseconds in a millisecond and 1,000,000
microseconds in a second.



Parameters
----------

None



Returns
-------

Number of microseconds since the program started (*unsigned long*)



Example
-------

::

    unsigned long time;

    void setup(){
      Serial.begin(9600);
    }
    void loop(){
      Serial.print("Time: ");
      time = micros();
      //prints time since program started
      Serial.println(time);
      // wait a second so as not to send massive amounts of data
      delay(1000);
    }



See also
--------


-  `millis <http://arduino.cc/en/Reference/Millis>`_\ ()
-  `delay <http://arduino.cc/en/Reference/Delay>`_\ ()
-  `delayMicroseconds <http://arduino.cc/en/Reference/DelayMicroseconds>`_\ ()



.. include:: cc-attribution.txt