gives the number of seconds remaining until the earliest enclosing TimeConstrained will request the current computation to stop.
- If constrained by several nested TimeConstrained wrappers, TimeRemaining returns the time to the earliest time constraint.
- Without an enclosing TimeConstrained, TimeRemaining returns Infinity.
- TimeRemaining is accurate only down to a granularity of at least $TimeUnit seconds.
- TimeRemaining is based on absolute real time, not just CPU time.
Examplesopen allclose all
Basic Examples (2)
Properties & Relations (4)
Without an enclosing TimeConstrained, TimeRemaining returns Infinity:
TimeRemaining returns the time to the earliest time constraint:
After 2 seconds, there are 3 seconds remaining until the outer constraint of 5 seconds:
TimeRemaining is based on absolute time ("wall clock time"), as measured by AbsoluteTiming:
The CPU time taken by the operation can be measured using Timing, and it is smaller:
The presence of AbortProtect may invalidate the times reported by TimeRemaining:
Wolfram Research (2020), TimeRemaining, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeRemaining.html.
Wolfram Language. 2020. "TimeRemaining." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/TimeRemaining.html.
Wolfram Language. (2020). TimeRemaining. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TimeRemaining.html