【Python入門】datetimeで日付や時刻を扱う方法を解説!

日付や時刻を扱うにはdatetimeモジュールを使用します。

システムやさまざまなアプリケーションでは日付を扱うことが多く、Pythonでももちろん日付を取得するためのdatetimeモジュールがあります。

dateteimeで日時を取得する方法が知りたい
日付同士を計算する方法が知りたい
日付を指定したフォーマットで取得する方法が知りたい

そこで今回はPythonで日付や時間を扱う時に必要なdatetimeモジュールについての解説をしていきます。

日付や時間を扱う場面は多いので、基本的な使い方をマスターしておいて損はありません。

この記事では、

  • 【基礎】datetimeモジュールとは何か
  • 【基礎】datetimeの基本的な使い方
  • 【発展】datetimeの実践的な使い方について

などについて詳しく解説していきます。

※ この記事のコードはPython 3.7, Ubuntu 18.04で動作確認しました。

datetimeとは

datetimeモジュールは、日付や時刻に対して色々な操作をすることが出来るモジュールです。

datetimeモジュールには、日付や時刻を扱うためのクラスが用意されています。

それらを組み合わせて活用することで、以下のような処理が可能になります。

  • 現在の日時を取得する
  • フォーマットを指定して取得する
  • 日付を計算する


など、日付に関する処理をより簡単に行うことが出来ます。

datetimeには大きく分けて、3種類のクラスがあります。

クラス説明
date主に日付を表現
time時刻を表現
datetime日付と時刻を合わせて表現

  • dateクラスでは主に日付を表現します
  • timeクラスでは時刻を表現します
  • datetimeクラスでは日付と時刻を合わせて表現します

datetimeの使い方

それでは実際にdatetimeを使ってみましょう。

現在の日付や時刻を取得する方法

現在の日付や時刻を取得するには、

  • datetime.date.today
  • datetime.datetime.now


を使います。

datetimeを使う前に、importを忘れないようにしましょう。

では実際に現在の日付や時刻を取得してみましょう。

実行結果

このように取得した日付型変数にtoday()、now()を指定することで現在の日付や日付と時刻を取得することができます。

また、年月日時分秒を単体で取得したい場合は、以下のように指定します。

実行結果

このように年・月・日・時・分・秒が簡単に取得できることがわかりますね!

日付の計算をする方法

日時を扱う時、日付の足し算や引き算などの処理が必要になる場面もあると思います。

予約システムを例に考えると、現在の日付から2日後に予約を開始したい場合は、日付を計算する必要が出てきます。

datetimeのtimedeltaを使うことで、日付の足し算や引き算が出来るようになります。

このサンプルコードを見てみましょう。

実行結果

このコードでは、現在から2日後の日付を表示させてみました。

2018年10月31日が現在の日にちなので、その2日後は確かに2018年11月2日ですね。

このようにtimedeltaクラスの引数として、任意の数字を渡すことで日時の計算が簡単に行えます。

また、このような日付の比較方法もあります。

こちらのサンプルコードを見てみましょう。

実行結果

このサンプルコードでは、今日と昨日と明日の日付をそれぞれ作成して比較しています。

今回のコードで使用したstr関数は、引数に渡されているものを文字列型へ変換してくれるものです。

このように、「>」や「<」を使って簡単に比較することが出来ます。

日付のフォーマットを変更する方法

datetimeのdateクラスは、先ほどのサンプルコードのように「yyyy-mm-dd」というフォーマットで結果を表示しています。

しかし、システムやサービスの仕様によっては別のフォーマットで日付を表したい場合もあると思います。

そのような時は、このようにフォーマットを指定することが可能です。

実行結果

このサンプルコードでは、formatメソッドを使って指定したフォーマットに任意の日時を変換させてみました。

today1はyyyy-mm-ddというフォーマットで表示されますが、変換後のtoday2はyyyy/mm/ddというフォーマットで表示されました。

formatメソッドについての詳しい解説は、こちらの記事をご覧ください。

【Python 入門】formatメソッドで変数の内容を出力する方法
更新日 : 2019年6月21日

文字列型をdatetime型に変換する方法

datetimeで得た日時の情報を、日付型として扱いたい場合と文字列型として扱いたい場合があると思います。

そのような時、文字列型・日付型への変換処理の方法を覚えておくととても便利です。

日付型→文字列型に変換

以下のサンプルでは日付型から文字列型に変換しています。

実行結果

このサンプルコードでは、strftimeを使って現在の日時を日付型から文字列型へ変換しました。

strftimeは、引数として指定したいフォーマットを入力します。今回はyyyy-mm-dd hh:mm:ssをフォーマットとして使っています。

変換前の型はdatetimeですが変換後はstrになっていますね。

type関数では引数に渡したものの型を調べることが出来ます。type関数についての詳しい解説はこちらの記事をご覧ください。

Pythonで型を確認するには?type・isinstance関数について解説
更新日 : 2019年8月6日

文字列型→日付型に変換

次に文字列型の日付を日付型に変換してみましょう。

実行結果

このサンプルコードでは、strptimeを使って文字列から日付型への変換を行いました。

strptimeには2つの引数を渡します。

第一引数には変換したい文字列を、第二引数にはフォーマットを表す文字列を渡します。

まとめ

今回はdatetimeモジュールを使った基本的な日付や日時の扱い方について解説しました。

  • datetimeモジュールとは何か
  • datetimeの基本的な使い方
  • datetimeの実践的な使い方について


大規模なプログラムではなくても、日付や日時を扱う場面はとても多いので覚えていて損はありません。

またformatメソッドやstr関数は日付や日時を扱う場面以外でもよく使われるので、ぜひ覚えておきましょう。

datetimeモジュールの使い方を忘れてしまったら、ぜひこの記事を見返してみてください!

LINEで送る
Pocket

最短でエンジニアを目指すなら侍エンジニア塾

cta_under_bnr

侍エンジニア塾は業界で初めてマンツーマンレッスンを始めたプログラミングスクールです。これまでの指導実績は16,000名を超え、未経験から数多くのエンジニアを輩出しています。

あなたの目的に合わせてカリキュラムを作成し、現役エンジニア講師が専属であなたの学習をサポートするため効率よく学習を進めることができますよ。

無理な勧誘などは一切ありません。まずは無料体験レッスンを受講ください。

無料体験レッスンの詳細はこちら

書いた人

Kotono

Kotono

イタリア在住15年目の22歳です。イタリアの大学で情報科学&応用数学を学んでいます。主にJavaScriptやPythonについての記事を書いたりしています。

おすすめコンテンツ

あなたにぴったりなプログラミング学習プランを無料で診断!

プログラミング学習の効率を劇的に上げる学習メソッドを解説