time(n) Tcl Built-In Commands time(n)

```

```

# [NAME](#NAME)

time - Time the execution of a script

# [SYNOPSIS](#SYNOPSIS)

**time script** ?*count*?

```

```

# [DESCRIPTION](#DESCRIPTION)

This command will call the Tcl interpreter *count* times to evaluate *script* (or once if *count* is not specified). It will then return a string of the form

```
503.2 microseconds per iteration
```

which indicates the average amount of time required per iteration, in microseconds. Time is measured in elapsed time, not CPU time.

# [EXAMPLE](#EXAMPLE)

Estimate how long it takes for a simple Tcl **for** loop to count to a thousand:

```
time {


    for {set i 0} {$i<1000} {incr i} {


        # empty body


    }
}
```

# [SEE ALSO](#SEE_ALSO)

[clock(n)](/man/os/tcl/clock.n)

# [KEYWORDS](#KEYWORDS)

script, time

Tcl

---

Document: time(n) from tcl 9.1.0-r1 (Chainguard OS)
Source: https://downloads.sourceforge.net/project/tcl/Tcl/9.1.0/tcl9.1.0-src.tar.gz