timedatectl: System Clock Controller

1 Description

The timedatectl program is part of the systemd suite of programs. The primary function of timedatectl is to control the system clock, and to manage time synchronization services.

2 Commands

Name Parameter Description
status Get the current settings of the system clock and RTC, including if time synchronization is active. This command is run when no command is specified.
show Get the same information as the status command but output in a machine-readable format.
set-time [TIME] Set the system clock to [TIME]. [TIME] should be something like 2025-06-14 18:13:45.
set-timezone [TIMEZONE] Set the system time zone to [TIMEZONE]. [TIMEZONE] needs to be something like US/Pacific. To obtain a list of timezones run the list-timezones command.
list-timezones List all timezones which timedatectl will recognize, one timezone per line. You can set the timezone of the system by using the set-timezone command.

This document was last updated: