The Linux timedatectl command lets you set your time, date, and timezone for your system clock and your real-time clock. Spare a moment, and we’ll show you how it all works.
It’s All Relative
Your computer’s treatment of time is one of those things that you might expect to be pretty straightforward. At least, until you start to look into it.
The Linux system clock counts the number of seconds since the Unix epoch. This was at 00:00:00 on Jan. 1, 1970, UTC. UTC stands for universal time coordinated but it is usually said as coordinated universal time or just universal time. This is the time standard by which the world manages and regulates time. Different time zones apply an offset to UTC to obtain their local time. Some time zones are ahead of UTC and others are behind it.
The system clock in Linux computers is software-based. Obviously, it cannot run when the computer is powered off. Another clock, a battery-backed hardware-based real-time clock, is able to run when the computer is off. Its purpose is to tell the system clock what time it is whenever Linux boots up. Unless access to a network time protocol (NTP) server is possible.
NTP servers are servers that provide accurate time information to computers that request it. If you boot up your computer or laptop and there is no internet access—or it hasn’t been configured to use NTP servers—the real-time clock is used to prime the system clock instead of an NTP Server.
The system clock is always in UTC. Any application that needs to acquire the local time needs to:
- Access the system clock and obtain UTC
- Know what time zone it is in and apply the correct offset
- Take into account whether daylight savings time is in effect
The conversion from UTC to local time is done by the application, not the system clock. Or, more accurately, the conversion is performed by the time and date libraries that the application is linked to. That’s why it is vital that your computer knows which timezone it is, what UTC time is, how many seconds have passed since the Unix epoch, and whether daylight savings time is in effect.
On systemd-based Linux distributions, we use the timedatectl command to see or change those settings and values.
Getting Started With timedatectl
To see the current data and time and other values, use the timedatectl command with the status operator.
timedatectl status
Actually, you can drop the status and you’ll still get the same output.
timedatectl
Both sets of output show:
- Local Time: The time the computer thinks it is, according to its time zone.
- Universal Time: The UTC time.
- RTC Time: The time the real-time clock is using. Usually, this is UTC.
- Time zone: Information regarding the configured time zone.
- System Clock Synchronized: Whether the system clock is synchronized with an NTP server.
- NTP Service: Whether the computer’s NTP service is active.
- RTC in local TZ: Whether the real-time clock is using the local time instead of UTC.
You can see how many time zones the timedatectl command supports by typing:
timedatectl list-timezones | wc -l
That’s way more than there are timezones in the world. If we pipe the output into grep and filter out the entries for “America” and pipe that into less, we can scroll through a more manageable list.
timedatectl list-timezones | grep "America/" | less
As you review that list you’ll see “America” is taken to have its widest possible meaning. The second thing you’ll notice is most of the entries aren’t actual time zones.
Setting the Time Zone
If you look through the unfiltered list of time zones supported by timedatectl you’ll see places as well as time zones. To set a time zone you can specify it by name like EST or GMT, or you can pick a location in the same time zone as you, like London or New York.
Resetting your time zone isn’t something you’ll be doing often, but perhaps you’ve moved home or you’re working away for a while and want to localize your laptop. If you need to reset your time zone, pick a location in the time zone you want to use.
We’ll set this computer to mountain time, which is the same time zone as Edmonton. We’ll then see how the settings have changed.
timedatectl set-timezone "America/Edmonton"
timedatectl
Our time zone has been changed, our local time has altered, and our offset from UTC has increased.
Manually Setting the Time and Date
Although manually setting the time and date is possible, usually you won’t need to. Using time synchronization and NTP is the preferred way to keep your computer’s time and date accurate. If you try to change your computers’ date or time you’ll probably get an error, telling you that time synchronization is in use.
timedatectl set-time 10:30:00
Use this command to turn off the time synchronization service:
sudo systemctl stop systemd-timesyncd.service
You can set the time, the date, or both using the timedatectl set-time operator. dates are in year-month-day order YYY-MM-DD, and time is in hours-minutes-seconds order HH:MM:SS. We’re going to set the time and date with this command:
timedatectl set-time "2022-01-30 10:30:00"
We’ll then check that the changes have taken place, using timedatectl.
timedatectl
The date and time have changed. Also, note the computer is using a false UTC time. We’re also informed that the system clock is not being synchronized and the NTP service is inactive.
If you have internet access, as soon as you restore the time synchronization service the time is retrieved and all of the details are correctly reset.
sudo systemctl start systemd-timesyncd.service
timedatectl
RTC: UTC or LTZ?
It’s possible to have your real-time clock set to your local time zone time instead of to UTC—possible, but inadvisable. If you make the change, you’ll see a warning about the dire effects this may have on your system in the future.
The reason for showing you this method is you might encounter a machine where they are having strange issues with their time settings. This is how to set the real-time clock back to UTC.
First, we’ll need to set it to the local time zone.
timedatectl set-local-rtc 1
Then we’ll ask timedatectl for its status.
timedatectl
I think they’ve made their feelings clear.
To restore the real-time clock to UTC, use this command:
timedatectl set-local-rtc 0
Set It and Forget It
Unless you made an error during the installation of your Linux distribution, or you relocate there’s usually no reason to be modifying the settings of your system and real-time clocks.
Set the system clock to your time zone, the real-time clock to UTC, and make sure you’re system is polling a network time protocol server. That’s the default state after most installations.
If they’re all set, your computer’s time systems will look after themselves.
