aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/millis.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/lang/millis.rst')
-rw-r--r--docs/source/lang/millis.rst70
1 files changed, 70 insertions, 0 deletions
diff --git a/docs/source/lang/millis.rst b/docs/source/lang/millis.rst
new file mode 100644
index 0000000..6ebfff5
--- /dev/null
+++ b/docs/source/lang/millis.rst
@@ -0,0 +1,70 @@
+.. _lang-millis:
+
+millis()
+========
+
+Description
+-----------
+
+Returns the number of milliseconds since the Arduino board began
+running the current program. This number will overflow (go back to
+zero), after approximately 50 days.
+
+
+
+Parameters
+----------
+
+None
+
+
+
+Returns
+-------
+
+Number of milliseconds since the program started (*unsigned long*)
+
+
+
+Example
+-------
+
+::
+
+ unsigned long time;
+
+ void setup(){
+ Serial.begin(9600);
+ }
+ void loop(){
+ Serial.print("Time: ");
+ time = millis();
+ //prints time since program started
+ Serial.println(time);
+ // wait a second so as not to send massive amounts of data
+ delay(1000);
+ }
+
+
+
+Tip:
+----
+
+Note that the parameter for millis is an unsigned long, errors may
+be generated if a programmer tries to do math with other datatypes
+such as ints.
+
+
+
+See also
+--------
+
+
+- `micros <http://arduino.cc/en/Reference/Micros>`_\ ()
+- `delay <http://arduino.cc/en/Reference/Delay>`_\ ()
+- `delayMicroseconds <http://arduino.cc/en/Reference/DelayMicroseconds>`_\ ()
+- `Tutorial: Blink Without Delay <http://arduino.cc/en/Tutorial/BlinkWithoutDelay>`_
+
+
+
+.. include:: cc-attribution.txt