Python 業務自動化 | 基礎自動化：現在時刻でログ名を作る

Python Python
スポンサーリンク
スポンサーリンク

Python自動化の基礎として、現在時刻でログ名を作る意味を理解する

Python自動化を学び始めると、ファイル操作、日付取得、時刻取得、画面表示、引数の受け取りなど、さまざまな基礎技術を少しずつ身につけていきます。その中でも、実務に近い自動化を考えると早い段階で覚えておきたいのが「現在時刻でログ名を作る」という考え方です。

ログとは、プログラムがいつ何をしたのかを記録しておくための情報です。たとえば、自動処理が何時に始まったのか、どのファイルを処理したのか、途中で何が起きたのか、正常終了したのか、それともエラーが出たのか、といった内容を残します。自動化では、人がその場でずっと見ているとは限らないため、あとから状況を確認できる記録がとても重要です。

ここで大切になるのがログファイルの名前です。毎回同じ log.txt に書き込む方法もありますが、それではいつの記録なのか分かりにくくなったり、別の実行結果と混ざったりしやすくなります。そこで、現在時刻を使ってログ名を作れば、実行ごとに名前を分けやすくなり、記録の整理や追跡がしやすくなります。

初心者の方は、最初は「ログ名に時刻を付けるのは少し細かすぎるのではないか」と感じるかもしれません。しかし、自動化は何度も繰り返し使うものです。同じ日に複数回実行することもありますし、失敗した実行と成功した実行をあとから比較したいこともあります。そうした場面では、現在時刻を含んだログ名が非常に役立ちます。

この記事では、Python自動化の基礎として、現在時刻でログ名を作る方法を、初心者向けに順を追って分かりやすく解説します。時刻の取得、ファイル名向けの整形、ログファイル作成、実践的なテンプレート、安全性の考え方まで、例題やコードを交えながら詳しく説明します。

まず理解したい、なぜ現在時刻でログ名を作るのか

実行ごとの記録を分けやすくなる

自動化スクリプトは、同じ日に何度も実行されることがあります。たとえば、テスト中に何回も動かすこともありますし、定期実行の設定によって1日複数回動くこともあります。このとき、すべての記録を同じログファイルに書き続けると、あとから見返したときに区別がしにくくなります。

そこで、現在時刻をログ名に含めておくと、「どの実行で作られたログなのか」が分かりやすくなります。たとえば log_20261021_143045.txt のような名前なら、2026年10月21日14時30分45秒に作られたログだとひと目で分かります。

上書き事故を防ぎやすくなる

毎回同じログ名を使うと、w モードで開いた場合に前回の内容を上書きしてしまう可能性があります。もちろん追記モードで使う方法もありますが、実行単位でログを分けたい場合には、時刻付きログ名のほうが安全で整理しやすいです。

特に初心者の方は、ログを残しているつもりでも、気づかないうちに前回分を消してしまうことがあります。そのため、最初から重複しにくい名前を作る設計を覚えておく価値があります。

Pythonで現在時刻を取得する基本

datetime.now() を使う

現在時刻を扱う基本は、datetime モジュールの datetime.now() です。これは、プログラムを実行したその瞬間の日時を取得します。

from datetime import datetime

<em># 現在の日時を取得します</em>
now = datetime.now()

<em># 取得した日時をそのまま表示します</em>
print(now)
Python

このコードでは、現在の年月日と時刻をまとめて取得できます。ただし、そのままではファイル名に使いにくいため、次にファイル名向けへ整形する必要があります。

時刻だけでなく、日付も一緒に使うのが一般的です

テーマは「現在時刻でログ名を作る」ですが、実務では時刻だけでなく日付も一緒に入れることが多いです。なぜなら、時刻だけでは別の日の同じ時間と区別しにくいからです。たとえば 143045 だけでは、何日の14時30分45秒なのか分かりません。

そのため、通常は日付と時刻を組み合わせてログ名を作ります。これは初心者のうちから覚えておくと、とても実用的です。

ファイル名に使いやすい時刻形式へ整える

strftime() で好きな形に変換する

取得した日時をファイル名に使うには、文字列へ整形する必要があります。そのために使うのが strftime() です。

from datetime import datetime

# 現在の日時を取得します
now = datetime.now()

# 日付と時刻をファイル名向けに整形します
timestamp = now.strftime("%Y%m%d_%H%M%S")

# 結果を表示します
print(timestamp)
Python

この形式なら、たとえば 20261021_143045 のような文字列が得られます。これはファイル名として扱いやすく、実行順に並べたときも自然です。

なぜコロンを使わないのか

初心者の方は、時刻を 14:30:45 のようにそのまま使いたくなるかもしれません。しかし、ファイル名ではコロンのような記号が環境によって問題になることがあります。そのため、ファイル名用には %H%M%S のように数字だけで整形するほうが安全です。

これはとても重要なポイントです。画面表示用の見やすい形式と、ファイル名用の扱いやすい形式は分けて考える必要があります。

ログ名を作る基本の考え方

固定部分と可変部分を分ける

ログ名を作るときは、ファイル名全体を1つのまとまりとして考えるよりも、固定部分と可変部分を分けて考えると分かりやすいです。

たとえば、log_20261021_143045.txt なら次のように分けられます。

  • 固定部分：log_
  • 日付と時刻の部分：20261021_143045
  • 拡張子：.txt

この考え方ができると、あとから error_log_ や backup_log_ のように応用しやすくなります。自動化では、変わる部分と変わらない部分を分けて考えることがとても大切です。

f文字列で自然に組み立てる

Pythonでは、f文字列を使うとログ名を分かりやすく組み立てられます。

from datetime import datetime

# 現在の日時を取得します
now = datetime.now()

# 日付と時刻を整形します
timestamp = now.strftime("%Y%m%d_%H%M%S")

# ログ名を作成します
log_file_name = f"log_{timestamp}.txt"

# 結果を表示します
print(log_file_name)
Python

この書き方は読みやすく、初心者の方にも扱いやすいです。自動化では文字列の組み立てをよく使うため、早めに慣れておくと役立ちます。

例題1 現在時刻でログ名を作って画面に表示する

最初に作るべき最小の例

まずは、現在時刻を使ってログ名を作り、その結果を画面に表示するシンプルな例を見てみます。

from datetime import datetime

# 現在時刻でログ名を作る関数です
def create_log_name():
    # 現在の日時を取得します
    now = datetime.now()

    # 日付と時刻をファイル名向けに整形します
    timestamp = now.strftime("%Y%m%d_%H%M%S")

    # ログファイル名を作成します
    log_file_name = f"log_{timestamp}.txt"

    # 結果を表示します
    print(f"作成するログ名は {log_file_name} です")

# メイン処理です
def main():
    create_log_name()

if __name__ == "__main__":
    main()
Python

この例は短いですが、自動化の大切な基本が含まれています。現在の情報を取得し、ファイル名に使いやすい形へ整え、固定文字列と組み合わせています。初心者の方はまず、この流れをしっかり理解するとよいです。

例題2 そのログ名で実際にログファイルを作る

ログ名を作るだけで終わらせない

次に、作ったログ名を使って実際にログファイルを作成する例を見ます。これにより、現在時刻でログ名を作る意味がよりはっきりします。

from datetime import datetime

# 現在時刻でログファイルを作成する関数です
def create_log_file():
    # 現在の日時を取得します
    now = datetime.now()

    # ファイル名向けの日時文字列を作成します
    timestamp = now.strftime("%Y%m%d_%H%M%S")

    # ログファイル名を作成します
    log_file_name = f"log_{timestamp}.txt"

    # ログファイルを作成して初期メッセージを書き込みます
    with open(log_file_name, mode="w", encoding="utf-8") as file:
        # 作成時刻を書き込みます
        file.write(f"ログ作成時刻: {now.strftime('%Y-%m-%d %H:%M:%S')}\n")
        file.write("自動処理を開始しました\n")

    # 完了メッセージを表示します
    print(f"{log_file_name} を作成しました")

# メイン処理です
def main():
    create_log_file()

if __name__ == "__main__":
    main()
Python

このコードでは、ファイル名にも本文にも時刻が入っています。ファイル名で実行単位を区別し、本文で詳細な記録を残すという考え方です。これは実務でもとてもよく使われます。

ここで深く理解したいポイント

ログ名とログ本文は役割が違います。ログ名は「どの実行の記録か」を大まかに識別するためのものです。一方、ログ本文は「その中で何が起きたか」を詳しく残すためのものです。この役割の違いを意識すると、ログ設計がぐっと分かりやすくなります。

例題3 複数の処理結果をそのログに書き込む

実際の自動化に近づける

ログファイルは作るだけでなく、その中へ処理の流れを書き込んでこそ意味があります。そこで、開始、処理中、終了をログへ残す例を見てみます。

from datetime import datetime

# ログファイル名を作成する関数です
def create_log_file_name():
    # 現在の日時を取得します
    now = datetime.now()

    # 日付と時刻を整形します
    timestamp = now.strftime("%Y%m%d_%H%M%S")

    # ログファイル名を返します
    return f"log_{timestamp}.txt"

# ログに1行追記する関数です
def write_log(log_file_name, message):
    # 現在時刻を取得します
    now = datetime.now()

    # 1行分のログメッセージを作成します
    log_line = f"{now.strftime('%Y-%m-%d %H:%M:%S')} {message}\n"

    # ログファイルへ追記します
    with open(log_file_name, mode="a", encoding="utf-8") as file:
        file.write(log_line)

# メイン処理です
def main():
    # ログファイル名を作成します
    log_file_name = create_log_file_name()

    # 開始ログを書き込みます
    write_log(log_file_name, "処理を開始しました")

    # サンプルの処理結果を書き込みます
    write_log(log_file_name, "ファイルAを処理しました")
    write_log(log_file_name, "ファイルBを処理しました")

    # 終了ログを書き込みます
    write_log(log_file_name, "処理を終了しました")

    # 作成したログ名を表示します
    print(f"{log_file_name} にログを書き込みました")

if __name__ == "__main__":
    main()
Python

この例では、ログファイル名は最初に1回だけ決めています。一方で、各行のログ時刻は書き込むたびに取得しています。この違いはとても大切です。ファイル名は1回の実行全体を表し、各行の時刻はその中の出来事の順序を表しています。

初心者がよくつまずくポイントと重要な注意点

ログ名の時刻と、ログ本文の時刻を混同しない

初心者の方は、ログ名に時刻が入っているから本文には不要ではないか、と考えることがあります。しかし実際には、両方に意味があります。ログ名の時刻はファイル全体の識別に使い、本文の時刻は行ごとの出来事を記録するために使います。

この2つを分けて考えられるようになると、ログ設計の理解がかなり深まります。

現在時刻を何度も取り直すとズレることがある

ログ名を作るとき、処理の途中で何度も datetime.now() を呼び出していると、秒の切り替わりによってファイル名と本文の時刻に微妙なズレが出ることがあります。通常は大きな問題ではありませんが、厳密に揃えたい場合は最初に1回取得した値を使い回すほうが安全です。

つまり、「どこでは1回だけ取得すべきか」「どこではその都度取得すべきか」を考えることが大切です。

時刻だけでは別日のログと区別しにくい

テーマが現在時刻であっても、実用上は日付も一緒に入れるのが基本です。時刻だけで log_143045.txt のようにすると、翌日の同じ時刻の実行と区別しにくくなります。初心者のうちは、時刻を使うときでも日付と組み合わせるのが標準、と考えておくと安全です。

セキュリティと運用の観点からの注意

ログに秘密情報を書かない

ログは便利ですが、何でも書いてよいわけではありません。パスワード、APIキー、個人情報、顧客情報などをそのままログへ書くと、あとでログファイルが見られたときに大きな問題になります。

初心者の方は、動作確認のために変数の中身を全部ログへ出したくなることがありますが、その中に秘密情報が含まれていないか注意が必要です。ログは「あとで見返すための記録」であると同時に、「漏えいしたら困る情報が残る場所」にもなり得ます。

ログファイルが増え続ける問題も意識する

現在時刻でログ名を毎回作ると、実行回数に応じてログファイルが増えていきます。これは便利な反面、放置すると大量のファイルがたまる原因にもなります。初心者の段階ではまず作れることが大切ですが、将来的には古いログを整理する仕組みも考える必要があります。

つまり、ログは作るだけでなく、どう管理するかも運用の一部です。

初心者向けの実用テンプレート

ここまでの内容を踏まえると、現在時刻でログ名を作る基本テンプレートは次のようになります。ログ名の作成、ログ書き込み、開始と終了の記録をまとめた形です。

from datetime import datetime

# ログファイル名を作る関数です
def make_log_file_name():
    # 現在の日時を取得します
    now = datetime.now()

    # ファイル名向けの日時文字列を作成します
    timestamp = now.strftime("%Y%m%d_%H%M%S")

    # ログファイル名を返します
    return f"log_{timestamp}.txt"

# ログに1行書き込む関数です
def write_log(log_file_name, message):
    # 現在の日時を取得します
    now = datetime.now()

    # ログ1行を作成します
    log_line = f"{now.strftime('%Y-%m-%d %H:%M:%S')} {message}\n"

    # ログファイルへ追記します
    with open(log_file_name, mode="a", encoding="utf-8") as file:
        file.write(log_line)

# メイン処理です
def main():
    # ログファイル名を作成します
    log_file_name = make_log_file_name()

    # 処理開始をログへ記録します
    write_log(log_file_name, "処理を開始します")

    # ここにメインの処理を書く想定です
    write_log(log_file_name, "サンプル処理を実行しました")

    # 処理終了をログへ記録します
    write_log(log_file_name, "処理を終了します")

    # 画面に結果を表示します
    print(f"{log_file_name} にログを記録しました")

if __name__ == "__main__":
    main()
Python

このテンプレートには、自動化で役立つ基本がしっかり入っています。ログ名で実行単位を分け、本文で出来事を記録し、画面にも結果を表示しています。初心者の方は、まずこの形を土台にして、対象ファイル名や処理結果などを少しずつ加えていくと学びやすいです。

学習を進めるときのおすすめの順番

現在時刻でログ名を作る技術を無理なく身につけるには、次の順番で進めるのがおすすめです。

  • まずは datetime.now() で現在日時を取得する
  • 次に strftime() でファイル名向けの文字列へ整形する
  • その次にログ名だけを作って画面へ表示する
  • 実際にその名前で空のログファイルを作る
  • ログ本文へ開始、途中、終了を書き込む
  • 最後に安全性や運用面も意識して改善する

この順番で学ぶと、文法だけでなく、なぜそうするのかという実務的な意味も理解しやすくなります。

まとめ

Python自動化の基礎として、現在時刻でログ名を作る技術はとても実用的です。実行ごとにログを分けやすくなり、上書き事故を防ぎやすくなり、あとから見返したときにも整理しやすくなります。特に同じ日に何度も実行する可能性がある自動化では、大きな価値があります。

大切なのは、現在時刻を取得し、それをファイル名に適した形へ整形して使うことです。また、ログ名の時刻と、ログ本文の時刻は役割が違うため、両方をうまく使い分けることも重要です。

初心者の方はまず、現在日時を取得してログ名を作り、画面へ表示するところから始めると良いです。そこからファイル作成、ログ書き込み、処理の記録へと発展させることで、自動化の実用性が大きく高まります。

現在時刻でログ名を作るという技術は、一見細かい工夫に見えて、実際には自動化の信頼性と運用性を支える大切な土台です。だからこそ、早い段階で丁寧に理解しておく価値があります。

スポンサーリンク
タイトルとURLをコピーしました