This article was originally posted on Everything DevOps.
Assuming you need to perform a task on a specific day sometime in the future. However, you know you will be away from the machine (computer) on that day. How will you perform the task? You can use the at terminal utility program to execute any non-interactive command at a specified time.
This article will teach you how to schedule future processes using the at command. In the end, you would have learned:
- How to schedule commands with
atusing a shell script, - How to schedule commands with
atinteractively, - When to use
atwith a shell script and when to useatinteractively, and - How to specify time and date when using
at.
Prerequisite
To follow this article, you need access to a Linux distribution terminal window. This article uses a Linux Ubuntu 18.04.6 LTS (Bionic Beaver) distribution.
Scheduling a command with at using a shell script
To schedule a command with at using a shell script, you will need to first create the script file.
In any directory, create a file testat.sh in the file, add:
#!/bin/bash
date > testingat.txt
The above shell script, when run, will write the date at that time to a testingat.txt file that the command will create as it doesn’t exist.
Next, in your terminal, make the shell script file executable with:
$ chmod +x testat.sh
After making it executable, with the at, queue the shell script up to execute precisely 2 minutes from now using:
$ at now + 2 minute -f testat.sh
Note: Suppose you get an error similar to Command 'at' not found. It means that the at utility program isn’t installed on your machine. The output should also prompt you on how to install it, as you can see below for the Ubuntu 18.04.6 LTS distribution used in this article.
After installing at, rerun the above command.
The above command creates a background job with job number 3 to execute 2 minutes from the time the at command ran, which was Thu May 19 15:06:00 2022 for this article.
Note: Your job number will be
1if you’re usingatfor the first time.
If you run $ ls, you will see that it is yet to be executed, and the testingat.txt file is yet to be created:
And you can run $ atq to see that the job is queued to run:
Once it’s two minutes past the time you ran the at command, run $ ls again, and you will see the testingat.txt has been created.
To test if the date was written to the testingat.txt file, run:
$ cat testingat.txt
The above command will print out the date on which it was run as specified in the shell script:
Interactively scheduling a task with at
Schedule a task with at interactively is similar to the shell script, but you use the at> prompt this time.
In your terminal using the same directory, run the command below to execute commands two minutes from now.
$ at now + 2 minute
The above will then open an interactive shell (annotated below). You will write the commands to be executed 2 minutes after logging out of the shell.
In the interactive shell, write the command below and press Enter.
$ date > testingat2.text
The above command writes the date at that time to a testingat2.text file that the command will create as it doesn’t exist.
Then log out of the shell with CTRL + D, and after 2 minutes, you will see the testingat2.text has been created.
When to use at with shell script and when to use at interactively
You should use at with a shell script:
- If you want to schedule many commands.
- If you're going to share the scheduled commands with someone else
You should use at interactively:
- If you want to schedule a single command, such as a system update
- If you want to work at a fast pace.
## Specifying time and date when using
at.
The at utility program uses a very casual representation of time and date. at even knows some "commonly used" times you might not expect — for instance, "teatime" which is traditionally at 4 PM.
Below are some examples of times you can pass to at to schedule a command. For instance, assuming the current time is 10:00 AM, Thursday, May 19, 2022. The expressions below would translate to the following times:
| The expression: | Would translate to: |
|---|---|
| noon | 12:00 PM May 19 2022 |
| midnight | 12:00 AM May 20 2022 |
| teatime | 4:00 PM May 19 2022 |
| tomorrow | 10:00 AM May 20 2022 |
| noon tomorrow | 12:00 PM May 20 2022 |
| next week | 10:00 AM May 26 2022 |
| next monday | 10:00 AM May 23 2022 |
| fri | 10:00 AM May 20 2022 |
| NOV | 10:00 AM November 19 2022 |
| 9:00 AM | 9:00 AM May 20 2022 |
| 2:30 PM | 2:30 PM May 19 2022 |
| 1430 | 2:30 PM May 19 2022 |
| 2:30 PM tomorrow | 2:30 PM May 20 2022 |
| 2:30 PM next month | 2:30 PM June 19 2022 |
| 2:30 PM Fri | 2:30 PM June 24 2022 |
| 2:30 PM 10/21 | 2:30 PM October 21 2022 |
| 2:30 PM Oct 21 | 2:30 PM October 21 2022 |
| 2:30 PM 10/21/2022 | 2:30 PM October 21 2022 |
| 2:30 PM 21.10.22 | 2:30 PM October 21 2022 |
| now + 30 minutes | 10:30 AM May 19 2022 |
| now + 1 hour | 11:00 AM May 19 2022 |
| now + 2 days | 10:00 AM May 19 2022 |
| 4 PM + 2 days | 4:00 PM May 21 2022 |
| now + 3 weeks | 10:00 AM June 9 2022 |
| now + 4 months | 10:00 AM September 19 2022 |
| now + 5 years | 10:00 AM May 19 2027 |
Conclusion
In this article, you learned how to schedule future processes using a shell script and the at> prompt with the at command. Also, you learned when to use each option and saw how to represent times in at.
Resources
There is more to learn about at. To learn more, check out the following resources:







Top comments (0)