初心者向け No.063

カウントダウンタイマー

指定日時まで残り日数・時間・分・秒をリアルタイム表示するカウントダウンアプリ。複数イベント対応。

🎯 難易度: ★☆☆ 📦 ライブラリ: tkinter（標準ライブラリ） ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

指定日時まで残り日数・時間・分・秒をリアルタイム表示するカウントダウンアプリ。複数イベント対応。

このアプリはtoolsカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★☆☆ です。

このアプリは「ツール」カテゴリです。日々の作業を自動化する実用ツールは Python が最も得意とする領域です。短いコードで実用性のある成果物が作れる点が魅力です。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

コピー＆実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。

アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。

カウントダウンタイマー実行画面（Windows） — 実行画面（Windows）

カウントダウンタイマー実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「追加」ボタン（add_event()）・「選択を削除」ボタン（delete_selected()）・「全消去」ボタン（clear_all()）で操作
after(1000, ...) による1000ミリ秒間隔の _tick() 呼び出し（画面の自動更新）
ttk.Treeview による表形式の一覧表示
messagebox.askyesno()・messagebox.showerror() によるダイアログ通知
ウィンドウはタイトル「カウントダウンタイマー」・サイズ 687x509 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

✅ 追加インストール不要（標準ライブラリのみ使用）

app063.py

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("687x509")
        self.root.minsize(687, 509)
        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 クラスにアプリの全機能をまとめています（メソッド8個・全154行）。__init__ ではタイトル「カウントダウンタイマー」とウィンドウサイズ 687x509 を設定します。あわせて状態を保持する変数（self._tick_after）を初期化し、そのあと _build_ui() → _tick() の順に呼び出して初期状態を作ります。