Python time ライブラリ完全ガイド

Python 標準ライブラリの time は、時間の管理や計測を行うための便利なツールです。本記事では、time ライブラリの基本概念から実践的な使用例までを詳しく解説します。

1. time ライブラリの概要

  • time は時刻の取得、フォーマット、処理時間の測定などに使用される標準ライブラリです。
  • UNIX 時間(エポックタイム)を基準とした時間管理が可能です。
  • 時間待機(スリープ)や高精度な時間計測もサポートしています。

インストール方法

time は Python の標準ライブラリなので、追加のインストールは不要です。

import time
--- ## 2. 主な機能と使用例 ### (1) 現在の時刻の取得
import time

# 現在の時刻(エポック秒)を取得
print("現在の時刻(UNIX時間):", time.time())

# 現在のローカル時間を取得
print("現在のローカル時間:", time.localtime())

# 読みやすい形式で取得
print("フォーマット済み時間:", time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()))
**使用例:** データのログにタイムスタンプを追加するときに活用できます。 --- ### (2) 時間のフォーマットと解析
import time

# 文字列から時間オブジェクトに変換
str_time = "2025-02-25 15:30:00"
time_obj = time.strptime(str_time, "%Y-%m-%d %H:%M:%S")
print("変換後の時間オブジェクト:", time_obj)

# 時間オブジェクトをUNIX時間に変換
epoch_time = time.mktime(time_obj)
print("UNIX時間:", epoch_time)
**使用例:** API から受け取った日付文字列をプログラムで扱いやすい形式に変換できます。 --- ### (3) 時間のスリープ(遅延処理)
import time

print("3秒待機中...")
time.sleep(3)
print("待機終了!")
**使用例:** 一定時間ごとにデータを取得するスクレイピングや、自動化スクリプトでの待機時間に利用できます。 --- ### (4) 高精度な時間計測
import time

start_time = time.perf_counter()

# 例として0.5秒待機
time.sleep(0.5)

end_time = time.perf_counter()
print("処理時間:", end_time - start_time, "秒")
**使用例:** 関数やアルゴリズムの処理時間を測定する際に使用できます。 --- ### (5) タイムゾーン情報の取得
import time

print("タイムゾーンのオフセット:", time.timezone)
print("夏時間のオフセット:", time.altzone)
print("夏時間の適用状況:", time.daylight)
**使用例:** 異なる地域の時刻を扱う際に、タイムゾーンの補正を行うのに利用できます。 --- ### (6) 経過時間の測定
import time

def heavy_process():
    time.sleep(2)

start = time.time()
heavy_process()
end = time.time()
print("処理時間:", end - start, "秒")
**使用例:** 処理のパフォーマンス測定や最適化のために使用できます。 --- ### (7) UTC 時間の取得
import time

print("現在のUTC時間:", time.gmtime())
print("フォーマット済みUTC時間:", time.strftime("%Y-%m-%d %H:%M:%S", time.gmtime()))
**使用例:** グローバルな時刻を扱う際に UTC を基準にすることで、時差を考慮せずに処理できます。 --- ### (8) 秒数を時間・分・秒に変換
import time

seconds = 3661
formatted_time = time.strftime("%H:%M:%S", time.gmtime(seconds))
print("変換後の時間:", formatted_time)
**使用例:** 秒数データを見やすい形式に変換する際に使用できます。 --- ## 3. `time` vs `datetime` の比較 | 機能 | `time` ライブラリ | `datetime` ライブラリ | |------------------|---------------|-----------------| | UNIX 時間の取得 | ✅ | ✅ | | ローカル時間の取得 | ✅ | ✅ | | 時間のフォーマット変換 | ✅ | ✅ | | 高精度な時間計測 | ✅ | ❌ | | タイムゾーンの管理 | ❌ | ✅ | --- ## まとめ Python の `time` ライブラリは、時間関連の処理を簡単に実装するための強力なツールです。ログのタイムスタンプ管理、処理時間の測定、スリープ処理など、さまざまな用途に活用できます。Python プログラムの時間管理にぜひ活用してください! 🚀