Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Tkinter clock widget
import tkinter
import time
Example tkinter Clock widget, counting seconds and minutes in realtime.
Functions just like a Label widget.
The Clock class has three functions:
__init__ creates the clock widget, which is just an ordinary label.
The tick() function rewrites the label every 200 milliseconds (5 times
each minute) to the current time. This updates the seconds.
The blink_colon() function rewrites the label every second, making the
colon appear to blink every second.
The secret sauce is tkinter's .after command. When a function completes,
the .after command triggers another (or the same) function to run after
a specified delay. __init__ triggers tick(), then tick() keeps triggering
itself until stopped.
All that complexity is hidden from you. Simply treat the clock as another
label widget with a funny name. *It should automatically work.*
How to add the clock widget:
tkinter.Label(parent, text="Foo").pack() # A widget
Clock(parent).widget.pack() # Just another widget
tkinter.Label(parent, text="Bar").pack() # Yet another widget
How to start/stop the clock widget:
You don't.
If you create a Clock().widget, the clock will start.
If you destroy the widget, the clock will also be destroyed.
To hide/restore the clock, use .pack_forget() and re-.pack().
The clock will keep running while hidden.
class Clock(tkinter.Label):
""" Class that contains the clock widget and clock refresh """
def __init__(self, parent=None, seconds=True, colon=False):
Create and place the clock widget into the parent element
It's an ordinary Label element with two additional features.
tkinter.Label.__init__(self, parent)
self.display_seconds = seconds
if self.display_seconds:
self.time = time.strftime('%H:%M:%S')
self.time = time.strftime('%I:%M %p').lstrip('0')
self.display_time = self.time
if colon:
self.after(200, self.tick)
def tick(self):
""" Updates the display clock every 200 milliseconds """
if self.display_seconds:
new_time = time.strftime('%H:%M:%S')
new_time = time.strftime('%I:%M %p').lstrip('0')
if new_time != self.time:
self.time = new_time
self.display_time = self.time
self.after(200, self.tick)
def blink_colon(self):
""" Blink the colon every second """
if ':' in self.display_time:
self.display_time = self.display_time.replace(':',' ')
self.display_time = self.display_time.replace(' ',':',1)
self.after(1000, self.blink_colon)
if __name__ == "__main__":
Create a tkinter window and populate it with elements
One of those elements merely happens to include the clocks.
The clock widget can be configure()d like any other Label widget.
Nothing special needs to be added to main(). The Clock class
updates the widget automatically when you create the widget.
# Create window and frame
window = tkinter.Tk()
frame = tkinter.Frame(window, width=400, height=400 )
# Add the frame elements, including the clock like any other element
tkinter.Label(frame, text="Clock with seconds:").pack()
clock1 = Clock(frame)
tkinter.Label(frame, text=" ").pack()
tkinter.Label(frame, text="Clock with blinking colon:").pack()
clock2 = Clock(frame, seconds=False, colon=True)
tkinter.Label(frame, text=" ").pack()
tkinter.Label(frame, text="Have a nice day.").pack()
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment