Python 業務自動化 | 基礎自動化:自動処理の開始時刻を記録する

Python Python
スポンサーリンク
スポンサーリンク
  1. Python自動化の基礎として、自動処理の開始時刻を記録する意味を理解する
  2. まず理解したい、なぜ開始時刻を記録するのか
    1. あとから「いつ動いたか」を確認できるようにするためです
    2. 処理時間の把握や改善にもつながるからです
  3. Pythonで現在日時を取得する基本
    1. datetime.now() を使う
    2. 取得した日時はそのままでも使えますが、整形すると見やすくなります
  4. ステップバイステップで考える、開始時刻記録の流れ
    1. 最初に処理開始の直前で現在時刻を取得する
    2. 次に、その値を画面表示やログへ残す
  5. 例題1 開始時刻を画面へ表示する
    1. 最初に作るべき最小の例
  6. 例題2 開始時刻をログファイルへ記録する
    1. 実際の運用に近い形へ進める
    2. 追記モードを使う意味を理解する
  7. 例題3 開始時刻を変数として持ちながら処理を進める
    1. あとで再利用しやすい形を覚える
  8. 開始時刻を記録するときに深く理解したい重要ポイント
    1. 「処理開始」とみなす位置を意識する
    2. 表示用の形式とファイル名用の形式は分けて考える
  9. 開始時刻の記録とログ設計の関係
    1. 開始時刻だけでも記録価値があります
    2. 将来的には終了時刻や処理結果と組み合わせられます
  10. 初心者がよくつまずくポイント
    1. 現在時刻を何度も取り直してしまう
    2. 記録しただけで満足して、あとで見返しにくい形式になる
    3. どこへ記録するかを決めていない
  11. セキュリティと安全性の観点からの注意
    1. 時刻記録だけでなく、何の処理かも分かるようにする
    2. ログへ機密情報を混ぜない
  12. 初心者向けの実用テンプレート
  13. 学習を進めるときのおすすめの順番
  14. まとめ

Python自動化の基礎として、自動処理の開始時刻を記録する意味を理解する

Python自動化を学び始めると、ファイル操作、日時取得、ログ出力、待機処理、条件分岐、関数化、設定管理など、少しずつ実用的な技術を身につけていきます。その中で、一見すると地味ですが、実際の運用では非常に重要なのが「自動処理の開始時刻を記録する」という考え方です。

初心者の方は最初、処理が動けばそれで十分だと考えがちです。しかし、自動化は一度動かして終わりではなく、何度も使い続けることが多いです。そのため、「いつ処理が始まったのか」を記録しておくことには大きな意味があります。たとえば、定期実行が予定どおり始まったか確認したいとき、異常が起きた時間帯をあとから調べたいとき、処理時間の目安をつかみたいときなどに役立ちます。

開始時刻の記録は、単なる飾りではありません。自動化の動きをあとから追跡しやすくし、トラブル時の確認や改善にもつながる大切な情報です。特に、画面を見ながら手作業で実行するのではなく、裏で自動的に動く処理が増えるほど、「何時に始まったか」という記録の価値は高まります。

この記事では、Python自動化の基礎として、自動処理の開始時刻を記録する方法を、プログラミング初心者向けにステップバイステップで詳しく解説します。なぜ必要なのか、どうやって取得するのか、画面表示やログへどう残すのか、どんな注意が必要かまで、例題やテンプレートを交えながらわかりやすく説明します。

まず理解したい、なぜ開始時刻を記録するのか

あとから「いつ動いたか」を確認できるようにするためです

自動化では、手で操作しているときのように、常にその場で動作を見ているとは限りません。とくに定期実行や繰り返し処理では、気づかないうちに動いていることが多いです。そこで、開始時刻を記録しておけば、「この処理は何時にスタートしたのか」をあとから確認できます。

たとえば、毎朝9時に動くはずの処理が本当に9時に始まっているか、想定より遅れていないか、異常発生時に何時頃の実行だったのか、といったことが分かるようになります。これは運用上とても大切です。

処理時間の把握や改善にもつながるからです

開始時刻を記録しておくと、あとで終了時刻と組み合わせることで、処理にどのくらい時間がかかったかも見やすくなります。初心者のうちはまず開始時刻だけでも十分ですが、将来的には「開始時刻と終了時刻の両方を記録する」という発展につながります。

つまり、開始時刻の記録は、単なる履歴ではなく、自動化の改善や運用の安定化にも役立つ土台です。

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

datetime.now() を使う

自動処理の開始時刻を記録するには、まず現在の日時を取得する必要があります。Pythonでは、datetime モジュールの datetime.now() を使うのが基本です。

from datetime import datetime

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

# 取得した日時を表示します
print(now)
Python

このコードでは、現在の年月日と時刻をまとめて取得できます。初心者の方はまず、「今この瞬間の日時をプログラムで取れる」という感覚をここでつかむことが大切です。

取得した日時はそのままでも使えますが、整形すると見やすくなります

datetime.now() で取得した値はそのままでも表示できますが、ログや画面表示では見やすい形に整えたほうが便利です。そのために使うのが strftime() です。

from datetime import datetime

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

# 見やすい形に整形します
start_time_text = now.strftime("%Y-%m-%d %H:%M:%S")

# 整形した結果を表示します
print(start_time_text)
Python

この形なら、たとえば 2026-10-23 09:30:15 のように、人が見て分かりやすい形になります。開始時刻の記録では、このような見やすい形式がよく使われます。

ステップバイステップで考える、開始時刻記録の流れ

最初に処理開始の直前で現在時刻を取得する

開始時刻を記録したいなら、もっとも大切なのは「どのタイミングで取得するか」です。基本的には、自動処理の本体が始まる直前で現在時刻を取得します。これにより、「実際に処理を始めた時刻」に近い値を記録できます。

初心者の方は、プログラムのかなり前の位置で日時を取得してしまうことがあります。しかし、準備処理の前に取りすぎると、本当の開始時刻と少しずれることがあります。そのため、どこを開始とみなすのかを意識することが大切です。

次に、その値を画面表示やログへ残す

日時を取得しただけでは意味がありません。あとから見返せるように、画面表示、ログファイル、または出力ファイルへ記録する必要があります。つまり、開始時刻の記録とは、「取得すること」と「残すこと」の2段階で考えると分かりやすいです。

例題1 開始時刻を画面へ表示する

最初に作るべき最小の例

まずは、処理開始時刻を画面へ表示する、もっとも基本的な例を見てみます。

from datetime import datetime

# 自動処理の開始時刻を表示する関数です
def show_start_time():
    # 現在の日時を取得します
    start_time = datetime.now()

    # 見やすい文字列へ整形します
    start_time_text = start_time.strftime("%Y-%m-%d %H:%M:%S")

    # 開始時刻を表示します
    print(f"処理開始時刻: {start_time_text}")

# メイン処理です
def main():
    # 開始時刻を表示します
    show_start_time()

    # ここに本来の自動処理を書く想定です
    print("自動処理を実行します")

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

この例はとても基本的ですが、「開始時刻を取得する」「見やすく整形する」「表示する」という重要な流れがすべて入っています。初心者の方はまず、この流れをしっかり理解すると良いです。

例題2 開始時刻をログファイルへ記録する

実際の運用に近い形へ進める

画面表示だけでは、その場でしか確認できません。自動化では、あとから見返せるようにログへ残すことがよくあります。そこで、開始時刻をログファイルへ書き込む例を見てみます。

from datetime import datetime

# 開始時刻をログファイルへ記録する関数です
def write_start_time_log(log_file_name):
    # 現在の日時を取得します
    start_time = datetime.now()

    # ログ用に見やすい文字列へ整形します
    start_time_text = start_time.strftime("%Y-%m-%d %H:%M:%S")

    # ログファイルへ追記します
    with open(log_file_name, mode="a", encoding="utf-8") as file:
        # 開始時刻を書き込みます
        file.write(f"処理開始時刻: {start_time_text}\n")

# メイン処理です
def main():
    # ログファイル名を指定します
    log_file_name = "process.log"

    # 開始時刻をログへ記録します
    write_start_time_log(log_file_name)

    # 本来の自動処理を実行する想定です
    print("自動処理を実行します")

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

この例では、ログファイルへ開始時刻を書き込んでいます。こうしておけば、あとで process.log を見て、「いつ処理が始まったか」を確認できます。実用的な自動化では、この形が非常によく使われます。

追記モードを使う意味を理解する

ここで mode="a" を使っているのは、以前の記録を消さずに追加していくためです。もし mode="w" にすると、毎回上書きされて過去の記録が消える可能性があります。開始時刻の履歴を残したいなら、追記モードを使う意味はとても大きいです。

例題3 開始時刻を変数として持ちながら処理を進める

あとで再利用しやすい形を覚える

開始時刻は、表示やログだけでなく、後続処理でも使いたくなることがあります。そのため、取得した時刻を変数として保持しておく形も大切です。

from datetime import datetime
import time

# メイン処理です
def main():
    # 処理開始時刻を取得します
    start_time = datetime.now()

    # 開始時刻を見やすい形で表示します
    print(f"処理開始時刻: {start_time.strftime('%Y-%m-%d %H:%M:%S')}")

    # サンプルとして2秒待機します
    time.sleep(2)

    # 本来の処理結果を表示します
    print("自動処理が進行中です")

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

このように、開始時刻を変数として持っておけば、あとで終了時刻との差を計算する発展にもつなげやすくなります。初心者の段階では、まず「取得した値をその場で捨てずに持っておくこともできる」と理解しておくとよいです。

開始時刻を記録するときに深く理解したい重要ポイント

「処理開始」とみなす位置を意識する

開始時刻を記録するとき、意外に重要なのが「どこを開始とするか」です。たとえば、プログラム起動直後なのか、設定読み込み後なのか、本体処理直前なのかで少し意味が変わります。

初心者の方は、何となく最初に日時を取得してしまいがちですが、それが本当に記録したい開始時刻かを考えることが大切です。もし「メインの自動処理が始まった時刻」を残したいなら、その直前で取得するべきです。逆に「プログラム全体の起動時刻」を記録したいなら、もっと前でもよいです。

つまり、開始時刻は単に取ればよいのではなく、「何の開始なのか」を意識して位置を決める必要があります。これは初心者が見落としやすいですが、とても重要な考え方です。

表示用の形式とファイル名用の形式は分けて考える

開始時刻を記録するとき、画面やログに表示するなら 2026-10-23 09:30:15 のような形が見やすいです。しかし、もしファイル名にも開始時刻を使いたい場合は、20261023_093015 のような別形式のほうが扱いやすいです。

このように、同じ時刻情報でも、用途によって整形方法を変える必要があります。表示用と保存用を分けて考える習慣は、自動化全体でとても役立ちます。

開始時刻の記録とログ設計の関係

開始時刻だけでも記録価値があります

ログというと、細かい処理内容をたくさん書くイメージがあるかもしれません。しかし、初心者のうちはまず、開始時刻だけでも十分意味があります。なぜなら、最低限「いつ動いたか」が残るからです。

とくに、自動処理が予定どおり起動しているかを確認したい場合には、開始時刻の記録だけでもかなり役立ちます。まずは小さく始めることが大切です。

将来的には終了時刻や処理結果と組み合わせられます

開始時刻を記録できるようになると、次は終了時刻や処理結果も一緒に記録したくなります。たとえば、開始、成功、失敗、終了、処理件数などをログへ残す設計へ発展できます。つまり、開始時刻の記録は、ログ設計の第一歩とも言えます。

初心者がよくつまずくポイント

現在時刻を何度も取り直してしまう

開始時刻を記録したいのに、表示用、ログ用、ファイル名用で何度も datetime.now() を呼んでしまうと、秒の境目で微妙に異なる値になることがあります。厳密に同じ開始時刻を使いたいなら、最初に1回だけ取得して、その値を使い回すほうが分かりやすいです。

初心者の方は、「必要な場面ごとに取り直す」のではなく、「同じ意味の時刻なら最初に取って使い回す」という考え方も覚えておくと良いです。

記録しただけで満足して、あとで見返しにくい形式になる

日時は記録できても、形式が見にくいと、あとから確認しづらくなります。たとえば、用途に合わない形式で保存すると、並べたときに順番が分かりにくくなることがあります。初心者のうちは、まず人が読みやすい形式を優先するとよいです。

どこへ記録するかを決めていない

開始時刻は、画面表示だけでよいのか、ログファイルへ残すのか、別ファイルへまとめるのかを考える必要があります。学習段階では画面表示だけでも構いませんが、運用を意識するなら「あとから見返せる形」を少しずつ意識していくとよいです。

セキュリティと安全性の観点からの注意

時刻記録だけでなく、何の処理かも分かるようにする

開始時刻だけを残しても、何の処理の記録なのか分からないと混乱することがあります。そのため、実務的には「どの自動処理の開始なのか」が分かるようにメッセージを添えることが大切です。これは運用上の見やすさだけでなく、監査や確認のしやすさにもつながります。

ログへ機密情報を混ぜない

開始時刻の記録そのものは安全性の高い情報であることが多いですが、ログを書く流れの中で、つい他の情報もまとめて出したくなることがあります。そのとき、パスワードや個人情報などを不用意に書かないよう注意が必要です。ログは後から見返せる便利な場所である一方、見られる可能性もある場所だと考えることが大切です。

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

ここまでの内容を踏まえると、自動処理の開始時刻を記録する基本テンプレートは次のようになります。開始時刻の取得、表示、ログ記録、処理実行という流れを整理した形です。

from datetime import datetime

# 開始時刻を記録する関数です
def record_start_time(log_file_name):
    # 現在の日時を取得します
    start_time = datetime.now()

    # 表示用の文字列へ整形します
    start_time_text = start_time.strftime("%Y-%m-%d %H:%M:%S")

    # 画面へ表示します
    print(f"処理開始時刻: {start_time_text}")

    # ログファイルへ追記します
    with open(log_file_name, mode="a", encoding="utf-8") as file:
        file.write(f"処理開始時刻: {start_time_text}\n")

    # あとで使えるように開始時刻を返します
    return start_time

# メイン処理です
def main():
    # ログファイル名を指定します
    log_file_name = "process.log"

    # 開始時刻を記録します
    start_time = record_start_time(log_file_name)

    # ここに本来の自動処理を書く想定です
    print("自動処理を実行します")

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

このテンプレートは、初心者が実際の自動化へ発展させやすい基本形です。開始時刻を取得し、画面にもログにも残し、さらに戻り値として保持しています。ここから終了時刻記録や処理時間計算へ広げることもできます。

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

自動処理の開始時刻を記録する技術をしっかり身につけるには、次の順番で進めると理解しやすいです。

  • まずは datetime.now() で現在日時を取得して表示する
  • 次に strftime() で見やすく整形する
  • その次に処理開始直前で取得する形にする
  • 画面表示だけでなくログファイルへも残す
  • 同じ開始時刻を変数として使い回す
  • 最後に終了時刻や処理時間の記録へ発展させる

この順番で進めると、単なる日時取得ではなく、自動化の運用記録としての意味まで自然に理解しやすくなります。

まとめ

Python自動化の基礎として、自動処理の開始時刻を記録する考え方は非常に重要です。開始時刻を残しておくことで、いつ処理が動いたかをあとから確認しやすくなり、トラブル時の調査や運用の見直しにも役立ちます。これは自動化を安定して運用するうえで、大切な土台です。

基本は、datetime.now() で現在日時を取得し、strftime() で見やすい形に整えて、画面表示やログへ残すことです。ただし、本当に大切なのは、どこを「開始」とみなすのかを意識し、同じ意味の時刻は1回取得して使い回すことです。

初心者の方はまず、画面に開始時刻を表示するところから始めると良いです。そこからログファイルへの記録、開始時刻の保持、終了時刻との組み合わせへと少しずつ発展させることで、自動化の記録設計がしっかり身についていきます。

自動処理の開始時刻を記録することは、一見小さな工夫に見えて、自動化の信頼性と追跡しやすさを支える大切な技術です。だからこそ、早い段階で丁寧に理解しておく価値があります。

タイトルとURLをコピーしました