TimeRemaining
✖
TimeRemaining
gives the number of seconds remaining until the earliest enclosing TimeConstrained will request the current computation to stop.
Details
- 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.
Examples
open allclose allBasic Examples (2)Summary of the most common use cases
After 1 second has elapsed, there are still 4 seconds remaining until the 5 second time constraint:
https://wolfram.com/xid/0dqu8hesq3e-ygyi00
Do not play this audio if there is not enough time to finish it:
https://wolfram.com/xid/0dqu8hesq3e-lfhs2p
https://wolfram.com/xid/0dqu8hesq3e-zxoru3
Properties & Relations (4)Properties of the function, and connections to other functions
Without an enclosing TimeConstrained, TimeRemaining[] returns Infinity:
https://wolfram.com/xid/0dqu8hesq3e-pskvj0
TimeRemaining[] returns the time to the earliest time constraint:
https://wolfram.com/xid/0dqu8hesq3e-tv210u
https://wolfram.com/xid/0dqu8hesq3e-c7wqzz
After 2 seconds, there are 3 seconds remaining until the outer constraint of 5 seconds:
https://wolfram.com/xid/0dqu8hesq3e-p6jxk9
TimeRemaining is based on absolute time ("wall clock time"), as measured by AbsoluteTiming:
https://wolfram.com/xid/0dqu8hesq3e-1pn1a
The CPU time taken by the operation can be measured using Timing, and it is smaller:
https://wolfram.com/xid/0dqu8hesq3e-cy0upq
The presence of AbortProtect may invalidate the times reported by TimeRemaining[]:
https://wolfram.com/xid/0dqu8hesq3e-dgjh2b
Wolfram Research (2020), TimeRemaining, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeRemaining.html.
Text
Wolfram Research (2020), TimeRemaining, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeRemaining.html.
Wolfram Research (2020), TimeRemaining, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeRemaining.html.
CMS
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. Wolfram Research. https://reference.wolfram.com/language/ref/TimeRemaining.html.
APA
Wolfram Language. (2020). TimeRemaining. Wolfram Language & System Documentation Center. Retrieved from 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
BibTeX
@misc{reference.wolfram_2024_timeremaining, author="Wolfram Research", title="{TimeRemaining}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/TimeRemaining.html}", note=[Accessed: 10-January-2025
]}
BibLaTeX
@online{reference.wolfram_2024_timeremaining, organization={Wolfram Research}, title={TimeRemaining}, year={2020}, url={https://reference.wolfram.com/language/ref/TimeRemaining.html}, note=[Accessed: 10-January-2025
]}