この記事のポイント
この記事では、datetime.fromtimestampについて基礎から応用まで詳しく解説していきます。プログラミング初心者の方でも理解できるよう、具体的なコード例を交えながら説明します。
- タイムスタンプを日時オブジェクトに変換する基本機能の習得
- さまざまな場面で使える実用的なコード例の理解
- 日時処理における効率的な活用方法の把握
以下の内容を順序立てて学習することで、datetime.fromtimestampを自由自在に使いこなせるようになります。
datetime.fromtimestampとは？
datetime.fromtimestampは、Unixタイムスタンプと呼ばれる数値を、人間が読みやすい日時形式に変換するためのメソッドです。
Unixタイムスタンプとは、1970年1月1日午前0時からの経過秒数を表す数値のことで、コンピューターシステムでは日時をこの形式で管理することが多くあります。このメソッドを使うことで、数値の羅列でしかないタイムスタンプを、年月日や時分秒といった直感的にわかる形式に変換できます。
プログラムでファイルの作成日時を取得したり、データベースから取得した日時情報を処理したりする際に、このメソッドが威力を発揮します。
【関連】
Pythonをもっと詳しく学ぶならpaizaラーニング
基本構文
datetime.fromtimestampの基本的な使い方を、具体的なコード例とともに見ていきましょう。最初にdatetimeモジュールをインポートしてから使用します。
from datetime import datetime
timestamp = 1735689600
dt = datetime.fromtimestamp(timestamp)
print(dt)
出力結果
2025-01-01 00:00:00
次に、現在時刻のタイムスタンプを取得して、それを再び日時形式に変換する例を示します。timeモジュールのtime関数で現在のタイムスタンプを取得できます。
import time
from datetime import datetime
current_timestamp = time.time()
current_dt = datetime.fromtimestamp(current_timestamp)
print(f"現在時刻: {current_dt}")
出力結果（例）
現在時刻: 2025-11-15 14:30:25.123456
※出力結果は実行した時刻により変動します。また、日時はUTC形式で計算されるため、日本時間での計算結果と異なります
実用例
ここからは、datetime.fromtimestampをさまざまな場面で活用する具体的なコード例を紹介していきます。実際の開発現場で遭遇しそうな状況を想定して、実践的なサンプルコードを用意しました。ファイル操作、ログ解析、データ処理など、多岐にわたる用途でのコード例を通じて、このメソッドの汎用性と有用性を実感していただけるでしょう。
それぞれのコード例には、実行前の説明と実行後の出力結果を併記しているため、動作をイメージしやすくなっています。これらの例を参考にして、ご自身のプロジェクトでも積極的に活用してみてください。
複数のタイムスタンプを一括変換
リスト内の複数のタイムスタンプを一度に処理する方法を示します。動物の名前と一緒にタイムスタンプを管理する例です。
from datetime import datetime
animal_data = [
("ネコ", 1640995200),
("イヌ", 1641081600),
("ウサギ", 1641168000)
]
for name, timestamp in animal_data:
dt = datetime.fromtimestamp(timestamp)
print(f"{name}の記録日時: {dt.strftime('%m/%d %H:%M')}")
出力結果
ネコの記録日時: 01/01 00:00
イヌの記録日時: 01/02 00:00
ウサギの記録日時: 01/03 00:00
時差を考慮した日時変換
タイムゾーンを指定して、世界各地の時刻で表示する方法です。pytzライブラリを使用して、正確な時差計算を行います。
from datetime import datetime
import pytz
timestamp = 1735689600
utc_dt = datetime.fromtimestamp(timestamp, tz=pytz.UTC)
tokyo_dt = utc_dt.astimezone(pytz.timezone('Asia/Tokyo'))
print(f"トラの観察時刻（東京）: {tokyo_dt}")
出力結果
トラの観察時刻（東京）: 2025-01-01 09:00:00+09:00
ログファイルの解析
システムログなどでよく見かけるタイムスタンプを、分析しやすい形式に変換する例です。ログの時刻パターンを調べる処理です。
from datetime import datetime
log_timestamps = [1735689600, 1735690200, 1735690800, 1735691400]
animals = ["キリン", "ゾウ", "ライオン", "サル"]
for i, timestamp in enumerate(log_timestamps):
dt = datetime.fromtimestamp(timestamp)
print(f"{animals[i]}のログ: {dt.strftime('%H:%M:%S')}")
出力結果
キリンのログ: 00:00:00
ゾウのログ: 00:10:00
ライオンのログ: 00:20:00
サルのログ: 00:30:00
データベースの日時フィールド処理
データベースから取得した数値形式の日時データを、アプリケーションで使いやすい形に変換する例です。辞書形式でデータを管理します。
from datetime import datetime
database_records = [
{"animal": "パンダ", "created_at": 1735689600},
{"animal": "コアラ", "created_at": 1735776000},
{"animal": "カンガルー", "created_at": 1735862400}
]
for record in database_records:
dt = datetime.fromtimestamp(record["created_at"])
record["formatted_date"] = dt.strftime('%Y-%m-%d')
print(f"{record['animal']}: {record['formatted_date']}")
出力結果
パンダ: 2025-01-01
コアラ: 2025-01-02
カンガルー: 2025-01-03
期間の計算と表示
タイムスタンプから日時オブジェクトを作成し、期間の計算を行う例です。動物の観察期間を計算する処理を示します。
from datetime import datetime
start_timestamp = 1735689600
end_timestamp = 1735862400
start_dt = datetime.fromtimestamp(start_timestamp)
end_dt = datetime.fromtimestamp(end_timestamp)
duration = end_dt - start_dt
print(f"シマウマの観察開始: {start_dt.strftime('%Y/%m/%d')}")
print(f"観察終了: {end_dt.strftime('%Y/%m/%d')}")
print(f"観察期間: {duration.days}日間")
出力結果
シマウマの観察開始: 2025/01/01
観察終了: 2025/01/03
観察期間: 2日間
エラーハンドリングを含む変換
不正なタイムスタンプ値に対する適切な例外処理を含む、堅牢なコードの例です。安全にタイムスタンプを処理する方法を示します。
from datetime import datetime
def safe_timestamp_convert(timestamp, animal_name):
if timestamp < 0:
return f"{animal_name}: 無効なタイムスタンプです"
try:
dt = datetime.fromtimestamp(timestamp)
return f"{animal_name}: {dt.strftime('%Y-%m-%d %H:%M')}"
except (ValueError, OSError):
return f"{animal_name}: 無効なタイムスタンプです"
timestamps = [
1735689600,
-1,
1735862400
]
animals = ["ハムスター", "リス", "フェレット"]
for ts, animal in zip(timestamps, animals):
print(safe_timestamp_convert(ts, animal))
出力結果
ハムスター: 2022-01-01 00:00
リス: 無効なタイムスタンプです
フェレット: 2022-01-02 00:00
まとめ
datetime.fromtimestampは、数値形式のタイムスタンプを人間が理解しやすい日時形式に変換する際に欠かせないメソッドです。基本的な使い方から応用的な活用方法まで、さまざまな場面でその価値を発揮します。このメソッドを適切に使いこなすことで、日時データの処理がより効率的かつ正確になり、プログラムの品質向上につながります。
datetime.fromtimestampの活躍する場面
- ファイルシステムの作成日時や更新日時の表示処理
- データベースから取得したタイムスタンプデータの変換作業
- ログファイルの解析や時系列データの可視化処理
重要なポイント
- タイムゾーンを明示的に指定することによる時差対応
- 不正な値に対する例外処理の実装による安全性確保
- フォーマット指定による用途に応じた表示形式の調整
これらの知識を身につけることで、日時処理における多くの課題を解決できるようになります。実際のプロジェクトでは、ここで紹介したコード例を参考にしながら、要件に応じてカスタマイズして活用してください。datetime.fromtimestampは、Pythonで日時を扱う際の基礎となるメソッドですので、ぜひ習得して日々の開発業務に役立ててください。
レベルを更に上げたい方はpaizaプログラミングスキルチェックへ
