初心者向け No.075

誕生日カウントダウン

複数人の誕生日を登録し次の誕生日まで何日かを一覧表示するアプリ。年齢計算と日付操作を学べる。

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

📋 目次

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

1. アプリ概要

複数人の誕生日を登録し次の誕生日まで何日かを一覧表示するアプリ。年齢計算と日付操作を学べる。

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

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

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

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

誕生日カウントダウン実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「追加」ボタン（add_person()）・「選択行を削除」ボタン（delete_selected()）・「JSON保存」ボタン（save_json()）・「JSON読込」ボタン（load_json()）・「全消去」ボタン（clear_all()）で操作
ttk.Treeview による表形式の一覧表示
JSON ファイルの保存（「JSON保存」ボタン）・読み込み（「JSON読込」ボタン）
filedialog.askopenfilename() によるファイル選択ダイアログ
filedialog.asksaveasfilename() によるファイル選択ダイアログ
messagebox.askyesno()・messagebox.showerror()・messagebox.showinfo() によるダイアログ通知
ウィンドウはタイトル「誕生日カウントダウン」・サイズ 700x500 で起動

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. 完全なソースコード

💡

コードのコピー方法

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

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

app075.py

import datetime as _dt
import json
import tkinter as tk
from tkinter import ttk, messagebox, filedialog


class App075:
    """誕生日カウントダウン"""

    def __init__(self, root):
        self.root = root
        self.root.title("誕生日カウントダウン")
        self.root.geometry("700x500")
        self.root.minsize(700, 500)
        self.root.configure(bg="#f8f9fc")
        # 登録データ: list of dict(name, birthday)
        self.people = []
        self._build_ui()
        self._refresh_view()

    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=16, pady=12)
        main.pack(fill=tk.BOTH, expand=True)

        form = ttk.LabelFrame(main, text="誕生日を登録", padding=10)
        form.pack(fill=tk.X, pady=(0, 8))

        ttk.Label(form, text="名前:").grid(row=0, column=0, sticky="w")
        self.name_var = tk.StringVar()
        ttk.Entry(form, textvariable=self.name_var, width=20).grid(row=0, column=1, padx=4)

        ttk.Label(form, text="誕生日(YYYY-MM-DD):").grid(row=0, column=2, sticky="w")
        self.bday_var = tk.StringVar()
        ttk.Entry(form, textvariable=self.bday_var, width=14).grid(row=0, column=3, padx=4)

        ttk.Button(form, text="追加", command=self.add_person).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="JSON保存", command=self.save_json).pack(side=tk.LEFT, padx=2)
        ttk.Button(btns, text="JSON読込", command=self.load_json).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, 0))
        cols = ("name", "birthday", "age", "days", "next")
        self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=14)
        for c, w, t in [("name", 130, "名前"), ("birthday", 110, "誕生日"),
                         ("age", 80, "現在の年齢"), ("days", 110, "あと何日"),
                         ("next", 200, "次の誕生日")]:
            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)

    def add_person(self):
        """誕生日を登録する"""
        name = self.name_var.get().strip()
        bday_s = self.bday_var.get().strip()
        if not name:
            messagebox.showerror("エラー", "名前を入力してください")
            return
        try:
            bday = _dt.date.fromisoformat(bday_s)
        except ValueError:
            messagebox.showerror("エラー", "誕生日は YYYY-MM-DD 形式で入力してください")
            return
        if bday > _dt.date.today():
            messagebox.showerror("エラー", "未来の日付は登録できません")
            return
        self.people.append({"name": name, "birthday": bday.isoformat()})
        self.name_var.set("")
        self.bday_var.set("")
        self._refresh_view()

    def delete_selected(self):
        """選択行を削除する"""
        sel = self.tree.selection()
        if not sel:
            messagebox.showinfo("情報", "削除する行を選択してください")
            return
        for item in sel:
            idx = int(self.tree.item(item, "tags")[0])
            self.people[idx] = None
        self.people = [p for p in self.people if p is not None]
        self._refresh_view()

    def clear_all(self):
        """全データを消去する"""
        if self.people and messagebox.askyesno("確認", "全て削除しますか?"):
            self.people.clear()
            self._refresh_view()

    def save_json(self):
        """JSONファイルとして保存する"""
        if not self.people:
            messagebox.showinfo("情報", "保存するデータがありません")
            return
        path = filedialog.asksaveasfilename(
            defaultextension=".json",
            filetypes=[("JSONファイル", "*.json")],
            initialfile="birthdays.json",
        )
        if not path:
            return
        try:
            with open(path, "w", encoding="utf-8") as f:
                json.dump(self.people, f, ensure_ascii=False, indent=2)
            messagebox.showinfo("完了", f"保存しました: {path}")
        except OSError as e:
            messagebox.showerror("エラー", f"保存に失敗しました: {e}")

    def load_json(self):
        """JSONファイルから読み込む"""
        path = filedialog.askopenfilename(filetypes=[("JSONファイル", "*.json")])
        if not path:
            return
        try:
            with open(path, "r", encoding="utf-8") as f:
                data = json.load(f)
            if not isinstance(data, list):
                raise ValueError("不正な形式です")
            for d in data:
                _dt.date.fromisoformat(d["birthday"])
                self.people.append({"name": d["name"], "birthday": d["birthday"]})
            self._refresh_view()
            messagebox.showinfo("完了", f"{len(data)} 件読み込みました")
        except (OSError, ValueError, KeyError, json.JSONDecodeError) as e:
            messagebox.showerror("エラー", f"読み込みに失敗しました: {e}")

    @staticmethod
    def _next_birthday(birthday: _dt.date, today: _dt.date) -> _dt.date:
        """今日以降の最も近い誕生日を返す"""
        try:
            this_year = birthday.replace(year=today.year)
        except ValueError:
            # 2/29 が誕生日で平年の場合は 3/1 として扱う
            this_year = _dt.date(today.year, 3, 1)
        if this_year < today:
            try:
                return birthday.replace(year=today.year + 1)
            except ValueError:
                return _dt.date(today.year + 1, 3, 1)
        return this_year

    def _refresh_view(self):
        """ツリービューを更新する"""
        self.tree.delete(*self.tree.get_children())
        today = _dt.date.today()
        rows = []
        for idx, p in enumerate(self.people):
            try:
                bday = _dt.date.fromisoformat(p["birthday"])
            except ValueError:
                continue
            nb = self._next_birthday(bday, today)
            days = (nb - today).days
            age_now = today.year - bday.year - ((today.month, today.day) < (bday.month, bday.day))
            rows.append((idx, p["name"], p["birthday"], age_now, days, nb.isoformat()))
        rows.sort(key=lambda r: r[4])
        for idx, name, bday_s, age, days, next_s in rows:
            label = "今日が誕生日!" if days == 0 else f"あと {days} 日"
            self.tree.insert("", tk.END, values=(name, bday_s, f"{age} 歳", label, next_s),
                             tags=(str(idx),))


if __name__ == "__main__":
    root = tk.Tk()
    app = App075(root)
    root.mainloop()

5. コード解説

誕生日カウントダウンのコードを、実際に書かれている実装に沿って解説します。

クラス設計とコンストラクタ

App075 クラスにアプリの全機能をまとめています（メソッド9個・全182行）。__init__ ではタイトル「誕生日カウントダウン」とウィンドウサイズ 700x500 を設定します。そのあと _build_ui() → _refresh_view() の順に呼び出して初期状態を作ります。