カウントダウンタイマー
指定日時まで残り日数・時間・分・秒をリアルタイム表示するカウントダウンアプリ。複数イベント対応。
1. アプリ概要
指定日時まで残り日数・時間・分・秒をリアルタイム表示するカウントダウンアプリ。複数イベント対応。
このアプリはtoolsカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★☆☆ です。
このアプリは「ツール」カテゴリです。日々の作業を自動化する実用ツールは Python が最も得意とする領域です。短いコードで実用性のある成果物が作れる点が魅力です。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。
コピー＆実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。
アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。
2. 機能一覧
- カウントダウンタイマーのメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
import datetime as _dt
import tkinter as tk
from tkinter import ttk, messagebox
class App063:
"""カウントダウンタイマー"""
def __init__(self, root):
self.root = root
self.root.title("カウントダウンタイマー")
self.root.geometry("680x500")
self.root.configure(bg="#f8f9fc")
# events: list of dict(name, target: datetime)
self.events = []
self._tick_after = None
self._build_ui()
self._tick()
def _build_ui(self):
"""UIを構築する"""
title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
title_frame.pack(fill=tk.X)
tk.Label(
title_frame, text="カウントダウンタイマー",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white"
).pack()
main = tk.Frame(self.root, bg="#f8f9fc", padx=18, pady=12)
main.pack(fill=tk.BOTH, expand=True)
# 入力
form = ttk.LabelFrame(main, text="イベント追加", padding=10)
form.pack(fill=tk.X)
ttk.Label(form, text="名前:").grid(row=0, column=0, sticky="w")
self.name_var = tk.StringVar()
ttk.Entry(form, textvariable=self.name_var, width=18
).grid(row=0, column=1, padx=4)
ttk.Label(form, text="日時(YYYY-MM-DD HH:MM):").grid(row=0, column=2, sticky="w")
self.dt_var = tk.StringVar(
value=(_dt.datetime.now() + _dt.timedelta(days=1)).strftime("%Y-%m-%d %H:%M")
)
ttk.Entry(form, textvariable=self.dt_var, width=18
).grid(row=0, column=3, padx=4)
ttk.Button(form, text="追加", command=self.add_event
).grid(row=0, column=4, padx=4)
btns = tk.Frame(main, bg="#f8f9fc")
btns.pack(fill=tk.X, pady=4)
ttk.Button(btns, text="選択を削除", command=self.delete_selected).pack(side=tk.LEFT, padx=2)
ttk.Button(btns, text="全消去", command=self.clear_all).pack(side=tk.LEFT, padx=2)
# リスト
list_frame = ttk.LabelFrame(main, text="残り時間（昇順表示）", padding=4)
list_frame.pack(fill=tk.BOTH, expand=True, pady=4)
cols = ("name", "target", "remain")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=12)
for c, w, t in [("name", 160, "イベント名"),
("target", 180, "目標日時"),
("remain", 280, "残り時間")]:
self.tree.heading(c, text=t)
self.tree.column(c, width=w, anchor="center")
self.tree.pack(fill=tk.BOTH, expand=True, side=tk.LEFT)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
# 現在時刻
self.now_var = tk.StringVar()
tk.Label(main, textvariable=self.now_var, bg="#f8f9fc",
font=("Noto Sans JP", 10)).pack(anchor="w", pady=(2, 0))
def add_event(self):
"""イベントを追加する"""
name = self.name_var.get().strip()
dt_s = self.dt_var.get().strip()
if not name:
messagebox.showerror("エラー", "イベント名を入力してください")
return
target = None
for fmt in ("%Y-%m-%d %H:%M", "%Y-%m-%d %H:%M:%S", "%Y-%m-%d"):
try:
target = _dt.datetime.strptime(dt_s, fmt)
break
except ValueError:
continue
if target is None:
messagebox.showerror("エラー", "日時は YYYY-MM-DD HH:MM 形式で入力してください")
return
self.events.append({"name": name, "target": target})
self.name_var.set("")
self._render()
def delete_selected(self):
"""選択イベントを削除"""
sel = self.tree.selection()
if not sel:
return
for item in sel:
idx = int(self.tree.item(item, "tags")[0])
self.events[idx] = None
self.events = [e for e in self.events if e is not None]
self._render()
def clear_all(self):
"""全イベントを削除"""
if self.events and messagebox.askyesno("確認", "全て削除しますか?"):
self.events.clear()
self._render()
@staticmethod
def _format_remaining(td: _dt.timedelta) -> str:
"""timedelta を 日 時間 分 秒 表記に"""
secs = int(td.total_seconds())
sign = ""
if secs < 0:
sign = "経過 "
secs = -secs
d, rem = divmod(secs, 86400)
h, rem = divmod(rem, 3600)
m, s = divmod(rem, 60)
return f"{sign}{d}日 {h:02d}時間 {m:02d}分 {s:02d}秒"
def _render(self):
"""ツリービュー再描画"""
now = _dt.datetime.now()
rows = sorted(enumerate(self.events),
key=lambda x: x[1]["target"])
self.tree.delete(*self.tree.get_children())
for idx, ev in rows:
remain = ev["target"] - now
self.tree.insert("", tk.END, values=(
ev["name"],
ev["target"].strftime("%Y-%m-%d %H:%M"),
self._format_remaining(remain),
), tags=(str(idx),))
self.now_var.set("現在時刻: " + now.strftime("%Y-%m-%d %H:%M:%S"))
def _tick(self):
"""1秒ごとに再描画"""
try:
self._render()
except tk.TclError:
return
self._tick_after = self.root.after(1000, self._tick)
if __name__ == "__main__":
root = tk.Tk()
app = App063(root)
root.mainloop()
5. コード解説
カウントダウンタイマーのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App063クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
UIレイアウトの構築
LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
イベント処理
ボタンのcommand引数でクリックイベントを、bind('
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
Textウィジェットでの結果表示
tk.Textウィジェットをstate=DISABLED（読み取り専用）で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
例外処理とエラーハンドリング
try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
6. ステップバイステップガイド
このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。
-
1ファイルを作成する
新しいファイルを作成して app063.py と保存します。
-
2クラスの骨格を作る
App063クラスを定義し、__init__とmainloop()の最小構成を作ります。
-
3タイトルバーを作る
Frameを使ってカラーバー付きのタイトルエリアを作ります。
-
4入力フォームを実装する
LabelFrameとEntryウィジェットで入力エリアを作ります。
-
5処理ロジックを実装する
_execute()メソッドにメインロジックを実装します。
-
6結果表示を実装する
TextウィジェットかLabelに結果を表示する_show_result()を実装します。
-
7エラー処理を追加する
try-exceptとmessageboxでエラーハンドリングを追加します。
7. カスタマイズアイデア
基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。
💡 ダークモードを追加する
bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。
💡 データの保存機能
処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。
💡 設定ダイアログ
フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。
8. よくある問題と解決法
❌ 日本語フォントが表示されない
原因：システムに日本語フォントが見つからない場合があります。
解決法：font引数を省略するかシステムに合ったフォントを指定してください。
❌ ライブラリのインポートエラー
原因：必要なライブラリがインストールされていません。
解決法：pip install コマンドで必要なライブラリをインストールしてください。
❌ ウィンドウサイズが合わない
原因：画面解像度や表示スケールによって異なる場合があります。
解決法：root.geometry()で適切なサイズに調整してください。
9. 練習問題
アプリの理解を深めるための練習問題です。
-
課題1：機能拡張
カウントダウンタイマーに新しい機能を1つ追加してみましょう。
-
課題2：UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。
-
課題3：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。