Like normal unix/linux/BSD sleep, sleep for 5 minutes:
vsleep 300
Also acepts a time to sleep until. Sleep until 9pm:
vsleep 21:00
vsleep 9 pm
vsleep 9pm
Target time accepts any format that's understood by date's DATE STRING. Integer-only values are interpreted as seconds of delay, and any other characters (including spaces) cause this argument to be interpreted as DATE STRING formatted target-times.
Sleep for 2 hours:
vsleep 2 hours
Sleep until 9pm tomorrow:
vsleep 21:00 tomorrow
Sleep until 9pm, 2 days from now:
vsleep 21:00 2 days
Sleep until 9pm Friday:
vsleep 21:00 Friday
Sleep for 3 days:
vsleep 3 days
Sleep until 7pm, 1 July, 2023:
vsleep 1 July 2023 19:00
vsleep 2023-07-01 19:00
Sleep until 7pm, 1 July, 2023, New York time, specified via epoch seconds:
TZ=America/New_York vsleep @1688252400
A time-zones can be explicitly specified via the TZ environment variable. Sleep until 8am GMT:
TZ=GMT vsleep 08:00
Sleep until 9pm, but randomly add 0-300 seconds of extra delay:
vsleep -j 300 21:00
Sleep until 9pm, but randomly add or subtract 0-300 seconds of delay:
vsleep -J 300 21:00
Verbose output can be supressed with the -q option, making this like a standard sleep command with extra functionality for interpreting target times.
Other verbosity options can be seen via the help menu:
vsleep -h
- Timing accuracy tends to be in the realm of 10-50mS, on my laptop. Close enough for anything that I intend to use it for.
- There's a
bashandshversion. They each do the same thing. In theory, the sh version should be more portable, but in practice the bash version is probably more portable.