Excel VBA Wait Function
VBA Wait is a built-in function used to pause the code from executing for a specified amount of time, it is very similar to what we do in a sleep command and to pause a code we use application.wait method.
Some of the codes require sometime before progress to the next line of code due to other tasks to be completed. In these cases, we need to stop the code from being executed and pause for some time, then proceed with the execution. We can pause the code to be executed in two ways, the first one is the “Sleep” method, and the second one is the “Wait” method. In our earlier article, we have discussed the “VBA SleepVBA SleepVBA Sleep is a windows function, present under the Windows DLL Files, which pauses the program execution for a specific time period (even in milliseconds).” method to pause the VBA codePause The VBA CodeVBA Pause helps to pause a code from executing for a particular period. You can pause the VBA code for a specific period by using two functions, and those functions are “Wait” & “Sleep.”.
“Wait,” as the name itself says, it will hold the macro code to be executed to a specified time frame. Using this method, we need to specify the time our code should pause. We will see examples next.
The syntax of the WAIT function is as follows.
We need to mention the amount of time our code should pause. As you can see in the end, it says Boolean. This means it returns the result as Boolean values, i.e., TRUE or FALSE.
Until the specified time arrived, it says FALSE, and the moment specified time arrived, it returns TRUE.
This is unlike the SLEEP function because WAIT is a built-in function where SLEEP is a Windows Function. Before we access the SLEEP function, we need to mention the below code at the top of the module. But WAIT doesn’t require this.
#If VBA7 Then Public Declare PtrSafe Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As LongPtr) ‘For 64 Bit Systems #Else Public Declare Sub Sleep Lib "kernel32" (ByVal dwMilliseconds As Long) ‘For 32 Bit Systems End If
Examples to use Excel VBA Wait Function
Assume you are working in an excel mid-day at 14:30:00, and you want your code to be paused until the time becomes 14:40:00. You can use the below code.
Sub Wait_Example1() Application.Wait "14:40:00" End Sub
The code will stop your excel from working until the time reaches 14:40:00 in your operating system. Providing time like this is dangerous because we don’t always work from 14:30:00. It keeps varying all the time.
Let’s say whenever you are running the code. You want to wait for 2 minutes, how do you refer to this in your code?
So, we can use the VBA NOWVBA NOWNOW is a date and time function in VBA which is used to get the current system date and time. VBA Now function does not takes any arguments and the return output for this function is date. function with TIME VALUE function to enter the specified time from the current time.
Just to remind you, the NOW () function returns the current date and time as per your computer system. TIMEVALUE function represents the time from 00:00:00 to 23:59:59 i.e. 11:59:59 P.M in 24 hours format. It converts the string value to a time value.
For Example NOW () + TIMEVALUE (00:02:30) means Current Time + 2 min 30 sec.
If the current time is 14:25:30, then it becomes 14:28:00.
To stop or pause your code from being executed from the current time to the next 10 minutes, you can use the below code.
Sub Wait_Example2() Application.Wait (Now() + TimeValue("00:10:00")) End Sub
It is important to use a NOW () function for accurate pause. Otherwise, there are chances your excel workbook paused until midnight. However, we can come out of the pause method at any point in time by pressing the Esc key or Break Key.
Wait for 10 Seconds Every time Loop Runs
The wait method is well used with loops. There are situations where you may require to wait for 10 seconds every time the loop runs. For example, look at the below data.
To calculate Profit = (Sales – Cost), you want to create a loop, and after every loop, you want to wait for 10 seconds to check whether the result is accurate or not. The below code will do that.
Sub Wait_Example3() Dim k As Integer For k = 2 To 9 Cells(k, 4).Value = Cells(k, 2) - Cells(k, 3) Application.Wait (Now() + TimeValue("00:00:10")) Next k End Sub
This code will calculate the profit column line by line. After the completion of the first line, it will wait for 10 seconds before it calculates the next line.
VBA Sleep vs. VBA Wait
|VBA SLEEP||VBA WAIT|
|It is not a VBA built-in function, needs a special code to access this function.||It is a VBA built-in function, doesn’t require any special code to access this function.|
|Sleep requires milliseconds as the time frame.||Wait requires a regular time frame.|
|We can delay the code in milliseconds.||We can delay only in whole seconds.|
This has been a guide to VBA Wait Function. Here we discuss how to use the wait method to pause the code from running with the help of practical examples and downloadable excel sheets. You can learn more about VBA from the following articles –