TimeConstrained
TimeConstrained[expr,t]
evaluates expr, stopping after t seconds.
TimeConstrained[expr,t,failexpr]
returns failexpr if the time constraint is not met.
Details

- TimeConstrained generates an interrupt to abort the evaluation of expr if the evaluation is not completed within the specified time.
- TimeConstrained evaluates failexpr only if the evaluation is aborted.
- TimeConstrained returns $Aborted if the evaluation is aborted and no failexpr is specified.
- TimeConstrained is accurate only down to a granularity of at least $TimeUnit seconds.
- Aborts generated by TimeConstrained are treated just like those generated by Abort, and can thus be overruled by AbortProtect.
- TimeConstrained[expr,Infinity] imposes no time constraint.
- TimeConstrained may give different results on different occasions within a single session, for example as a result of different conditions of internal system caches.
- TimeConstrained takes account only of CPU time spent inside the main Wolfram Language kernel process; it does not include additional threads or processes.
Examples
open allclose allBasic Examples (2)
Properties & Relations (1)
TimeRemaining[] gives the number of seconds until the enclosing TimeConstrained aborts the evaluation:
Text
Wolfram Research (1988), TimeConstrained, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeConstrained.html (updated 2007).
BibTeX
BibLaTeX
CMS
Wolfram Language. 1988. "TimeConstrained." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2007. https://reference.wolfram.com/language/ref/TimeConstrained.html.
APA
Wolfram Language. (1988). TimeConstrained. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TimeConstrained.html