TimeLeftUntilTargetTimeOfDay — Get how much time remains between now and the target time.
The time left until the target time of day, in the form xH yM zS (for hours, minutes, and seconds, respectively). If the target time is already past, then the return value is prefixed with a minus sign.
| TargetTimeOfDay | Time of day to measure the distance to. |
Time is returned in the format "xH yM zS", where x is the number of hours, y is the number of minutes, and z is the number of seconds.
For information about how to configure the format, see About Date and Time Commands.
For information regarding exceptions / errors, see
here.
% # Suppose that it is now 11:00:00
% TimeLeftUntilTargetTimeOfDay 12:00:00
1H 0M 0S
% # Suppose that it is now 12:00:00
% TimeLeftUntilTargetTimeOfDay 11:00:00
-1H 0M 0S