Python の日時および日付モジュール

この記事ではPythonの日時処理モジュール(dateとdatetime)を中心に紹介していますが、編集者がとても良いと思ったので、参考として共有させていただきます。編集者をフォローして一緒に見てみましょう

はじめに

開発作業では、次のような日付と時刻を使用する必要があることがよくあります:

• ログ情報の内容出力として

• に特定の関数の実行時間を計算します

• 日付を含むログファイルに名前を付けます

• 記事の公開時刻または変更時刻を記録または表示します

• その他

Pythonは日付と日付を表す複数の関数を提供します時間操作用の組み込みモジュール: time モジュール、datetime モジュール、calendar モジュール。 time モジュールは C ライブラリを呼び出すことによって実装されるため、一部のプラットフォームでは一部のメソッドが呼び出されない場合がありますが、提供されるほとんどのインターフェースは基本的に C 標準ライブラリ time.h と一致しています。 time モジュールと比較して、datetime モジュールによって提供されるインターフェイスは、より直観的で使いやすく、より強力です。

1. 関連用語の説明

• UTC 時間 協定世界時、グリニッジ天文時および世界標準時とも呼ばれます。 UTC 時間は各タイム ゾーンの現地時間に対応します。東 N ゾーンの時間は UTC 時間よりも N 時間早いため、UTC 時間 + N 時間が東 N ゾーンの現地時間になります。 UTC 時間より N 時間遅い、つまり UTC 時間 - N 時間は西 N ゾーンの現地時間です。中国は東 8 ゾーンにあるため、UTC+ として表現できます。 8.

• エポック時間は時間の開始点を表します。これは特定の時間であり、異なるプラットフォームでのこの時点の値は同じではありません。Unix の場合、エポック時間は 1970-01-01 00:00:00 です。 UTC 。

• タイムスタンプ (Timestamp) は、Unix 時間または POSIX 時間とも呼ばれ、1970 年 1 月 1 日 GMT の 0:00:00 から現在までの経過時間をミリ秒単位で表します。 、その値は float 型です。 ただし、一部のプログラミング言語の関連メソッドは秒数を返します (これは Python の場合です)。これには、メソッドのドキュメントを参照する必要があります。タイムスタンプは差分値であり、その値はタイムゾーンとは関係がないことに注意してください。

2. 時間の表現形式

一般的な時間の表現形式は次のとおりです:

• Timestamp

• Formatted time

  String

Pythonには他にもあります

その他の 時間表現:

• time モジュールの time.struct_time

• datetime モジュールの datetime クラス

datetime モジュールの datetime クラスについては、以下で簡単に説明します。

time.struct_time には次の

プロパティが含まれます:

subscript/プロパティ名説明0tm_year 年 (2017 など) 1 tm_mon月、値の範囲は[1, 12]です2tm_mday日、値の範囲は[1-31]です3 tm_hour 時間、値の範囲は [0-23]4tm_min 分、値の範囲は [0, 59]5tm_sec 秒、値の範囲それは[0, 61]です6tm_wday曜日、値の範囲は[0-6]、0は月曜日を意味します7tm_yday1年間の数値の日数の値の範囲は [1, 366] です8tm_isdst 夏時間であるかどうかにかかわらず、可能な値は次のとおりです: 0、1 または -1

属性値を取得するには 2 つの方法があります:

• それを特別な順序の不変シーケンスとして扱い、t[0] などの添え字/インデックスを通じて各要素の値を取得できます

• を使用することもできます.各要素の値を取得するための属性名 (t.tm_year など)。

struct_time インスタンスの各属性は読み取り専用であり、変更できないことに注意してください。

3. 時間モジュール

このモジュールは主に時間に関連するさまざまな 関数 を提供します。

1. 関数リスト

index

に変更されました。 Python 3.3 の場合

メソッド/プロパティ

説明

time.altzone

UTC 時間との時差を秒単位で返します (値は西ゾーンでは正であり、東ゾーンでは正)、値は負です)。これはローカル DST タイム ゾーンのオフセットを表し、夏時間が 0 以外の場合にのみ使用されます。

time.clock()

現在のプロセスによって消費されたプロセッサ実行時間の秒数を返します(スリープ時間を除く)。値は10進数です。このメソッドはtime.process_time()

time.asctime([t])

タプルまたは struct_time (gmtime() および localtime() メソッドを通じて取得できます) の形式の時刻を、次の形式の 24 文字の時刻文字列に変換します。 「2016年8月19日金11時14分16秒」。パラメータ t が指定されていない場合は、localtime() の戻り値がパラメータとして使用されます。

time.ctime([secs])

関数は上記と同じで、秒のタイムスタンプで表される時間を現在の現地時間を表す文字列に変換します。パラメータ secs が指定されていないか、値が None の場合、time() メソッドの戻り値がデフォルト値として使用されます。 ctime(secs) は asctime(localtime(secs)) と同等です

time.time()

タイムスタンプ (1970-1-1 0:00:00 からの秒数) を返します

time .localtime([secs])

指定されたタイムスタンプに対応する現地時間に対応するstruct_timeオブジェクトを返します(添字または.属性名で参照可能)。 + n*3600)n 時間後の現地時間の struct_time オブジェクト形式を返します (crontab と同様の関数の実装に使用できます)

time.gmtime([secs])

次の struct_time オブジェクト形式を返します指定されたタイムスタンプに対応する UTC 時刻 (現在の現地時刻とは 8 時間異なります)

time.gmtime(time.time() + n*3600)

n 時間後の UTC 時刻を返します struct_time オブジェクト (内部属性は .attribute name で参照できます) format

time.strptime(time_str, time_format_str)

時間文字列を struct_time 時間オブジェクトに変換します。次のようになります。 time.strptime('2017- 01-13 17:07 ', '%Y-%m-%d %H:%M')

time.mktime(struct_time_instance)

struct_time オブジェクトのインスタンスをタイムスタンプに変換します

time(time_format_str, struct_time_instance)

。 struct_time オブジェクトのインスタンスを文字列に変換します

2. 演習

タイムスタンプ形式で時間を取得します

>>> time.time()
1486188022.862

struct_time形式で時間を取得します

>>> time.localtime()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=2, tm_sec=34, tm_wday=5, tm_yday=35, tm_isdst=0)
>>> time.gmtime()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=6, tm_min=2, tm_sec=56, tm_wday=5, tm_yday=35, tm_isdst=0)

文字列形式で時間を取得します

>>> time.ctime()
'Sat Feb 04 14:06:42 2017'
>>> time.asctime()
'Sat Feb 04 14:06:47 2017'

時間を変換しますスタンプ形式からstruct_time形式へtime

>>> t1 = time.time()
>>> print(t1)
1486188476.9
>>> t2 = time.localtime(t1)
>>> print(t2)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=7, tm_sec=56, tm_wday=5, tm_yday=35, tm_isdst=0)
>>> t3 = time.gmtime(t1)
>>> print(t3)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=6, tm_min=7, tm_sec=56, tm_wday=5, tm_yday=35, tm_isdst=0)
>>>

文字列形式をstruct_time形式に変換します time

>>> time.strptime('Sat Feb 04 14:06:42 2017')
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=6, tm_sec=42, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime('Sat Feb 04 14:06:42 2017', '%a %b %d %H:%M:%S %Y')
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=6, tm_sec=42, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime('2017-02-04 14:12', '%Y-%m-%d %H:%M')
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=12, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime('2017/02/04 14:12', '%Y/%m/%d %H:%M')
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=12, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime('201702041412', '%Y%m%d%H%M')
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=12, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)

struct_time形式を文字列形式に変換します time

>>> time.strftime('%Y-%m-%d %H:%M', time.localtime())
'2017-02-04 14:19'

struct_time格式转时间戳格式时间
>>> time.mktime(time.localtime())
1486189282.0

3. 時刻形式の変換

タイムスタンプ形式の時刻と文字列形式の時刻の変換はOKですctime([secs]) メソッドを通じて実行されますが、文字列形式は中国の国情に適していません。したがって、全体として、これらを直接変換することはできず、仲介として struct_time を使用する必要があります。変換関係は次のとおりです。

注: 上記の '%H:%M:%S' は直接置き換えることができます。 '%X' によって。

4. Datetime モジュール

datetime モジュールは、単純な方法と複雑な方法の両方で日付と時刻を処理するためのクラスを提供します。日付と時刻のアルゴリズムをサポートしていますが、その実装の焦点は、出力の書式設定と操作のための効率的な属性抽出機能を提供することです。

1. datetime モジュールで定義されたクラス

datetime モジュールは次のクラスを定義します:

datetime.datetimeは日付と時刻を表します。 timedelta 2 つの日付、時刻、日時インスタンス間の時間間隔を表します。解像度 (最小単位) はマイクロ秒に達します。datetime.tzinfo タイムゾーン関連の情報オブジェクトの抽象基本クラス。これらは、日時クラスと時刻クラスによってカスタムの時刻調整を提供するために使用されます。 datetime.timezone Python 3.2 には、tzinfo 抽象基本クラスを実装し、UTC からの固定オフセットを表す新しい これらのクラスのオブジェクトは次のとおりであることに注意してください。は不変です。

クラス名	説明
datetime.date	は日付を表します。年、月、日です
datetime.time	は時間を表します。一般的に使用される属性は、時、分、秒、マイクロ秒です
	関数があります

クラス間の関係:

object
 date
 datetime
 time
 timedelta
 tzinfo
 timezone

2.

datetimeモジュールで定義された定数

定数名datetime.MINYEARdatetime.MAXYEAR

説明
datetime .date または datetime の最小値。 datetime オブジェクトで許可される年の最大値は 1
datetime.date または datetime.datetime オブジェクトで許可される年の最大値は 9999

3 のみです。 class

datetime.date クラス定義

class datetime.date(year, month, day)

年、月、日はすべて必須パラメータです。各パラメータの値の範囲は次のとおりです。

パラメータ名クラスのメソッドとプロパティクラスメソッド/プロパティ名説明date.max日付オブジェクトが表現できる最大日付: 9999-12-31date.mindateオブジェクトが表現できる表される最小のログ: 00001-01-01

値の範囲

date.resoluation 日付オブジェクトによって表される日付の最小単位: daysdate.today() 現在のローカルを表す日付オブジェクトを返します。 datedate.fromtimestamp(timestamp)指定されたタイムスタンプに基づいて日付オブジェクトを返します

对象方法和属性

对象方法/属性名称	描述
d.year	年
d.month	月
d.day	日
d.replace(year[, month[, day]])	生成并返回一个新的日期对象，原日期对象不变
d.timetuple()	返回日期对应的time.struct_time对象
d.toordinal()	返回日期是是自 0001-01-01 开始的第多少天
d.weekday()	返回日期是星期几，[0, 6]，0表示星期一
d.isoweekday()	返回日期是星期几，[1, 7], 1表示星期一
d.isocalendar()	返回一个元组，格式为：(year, weekday, isoweekday)
d.isoformat()	返回‘YYYY-MM-DD'格式的日期字符串
d.strftime(format)	返回指定格式的日期字符串，与time模块的strftime(format, struct_time)功能相同

实例

>>> import time
>>> from datetime import date
>>>
>>> date.max
datetime.date(9999, 12, 31)
>>> date.min
datetime.date(1, 1, 1)
>>> date.resolution
datetime.timedelta(1)
>>> date.today()
datetime.date(2017, 2, 4)
>>> date.fromtimestamp(time.time())
datetime.date(2017, 2, 4)
>>>
>>> d = date.today()
>>> d.year
2017
>>> d.month
2
>>> d.day
4
>>> d.replace(2016)
datetime.date(2016, 2, 4)
>>> d.replace(2016, 3)
>>> d.replace(2016, 3, 2)
datetime.date(2016, 3, 2)
>>> d.timetuple()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> d.toordinal()
736364
>>> d.weekday()
5
>>> d.isoweekday()
6
>>> d.isocalendar()
(2017, 5, 6)
>>> d.isoformat()
'2017-02-04'
>>> d.ctime()
'Sat Feb 4 00:00:00 2017'
>>> d.strftime('%Y/%m/%d')
'2017/02/04'

4. datetime.time类

time类的定义

class datetime.time(hour, [minute[, second, [microsecond[, tzinfo]]]])

hour为必须参数，其他为可选参数。各参数的取值范围为：

参数名称	取值范围
hour	[0, 23]
minute	[0, 59]
second	[0, 59]
microsecond	[0, 1000000]
tzinfo	tzinfo的子类对象，如timezone类的实例

类方法和属性

类方法/属性名称	描述
time.max	time类所能表示的最大时间：time(23, 59, 59, 999999)
time.min	time类所能表示的最小时间：time(0, 0, 0, 0)
time.resolution	时间的最小单位，即两个不同时间的最小差值：1微秒

对象方法和属性

对象方法/属性名称	描述
t.hour	时
t.minute	分
t.second	秒
t.microsecond	微秒
t.tzinfo	返回传递给time构造方法的tzinfo对象，如果该参数未给出，则返回None
t.replace(hour[, minute[, second[, microsecond[, tzinfo]]]])	生成并返回一个新的时间对象，原时间对象不变
t.isoformat()	返回一个‘HH:MM:SS.%f'格式的时间字符串
t.strftime()	返回指定格式的时间字符串，与time模块的strftime(format, struct_time)功能相同

实例

>>> from datetime import time
>>>
>>> time.max
datetime.time(23, 59, 59, 999999)
>>> time.min
datetime.time(0, 0)
>>> time.resolution
datetime.timedelta(0, 0, 1)
>>>
>>> t = time(20, 5, 40, 8888)
>>> t.hour
20
>>> t.minute
5
>>> t.second
40
>>> t.microsecond
8888
>>> t.tzinfo
>>>
>>> t.replace(21)
datetime.time(21, 5, 40, 8888)
>>> t.isoformat()
'20:05:40.008888'
>>> t.strftime('%H%M%S')
'200540'
>>> t.strftime('%H%M%S.%f')
'200540.008888'

5. datetime.datetime类

datetime类的定义

代码如下:

class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None)

year, month 和 day是必须要传递的参数， tzinfo可以是None或tzinfo子类的实例。

各参数的取值范围为：

参数名称	取值范围
year	[MINYEAR, MAXYEAR]
month	[1, 12]
day	[1, 指定年份的月份中的天数]
hour	[0, 23]
minute	[0, 59]
second	[0, 59]
microsecond	[0, 1000000]
tzinfo	tzinfo的子类对象，如timezone类的实例

如果一个参数超出了这些范围，会引起ValueError异常。

类方法和属性

类方法/属性名称	描述
datetime.today()	返回一个表示当前本期日期时间的datetime对象
datetime.now([tz])	返回指定时区日期时间的datetime对象，如果不指定tz参数则结果同上
datetime.utcnow()	返回当前utc日期时间的datetime对象
datetime.fromtimestamp(timestamp[, tz])	根据指定的时间戳创建一个datetime对象
datetime.utcfromtimestamp(timestamp)	根据指定的时间戳创建一个datetime对象
datetime.combine(date, time)	把指定的date和time对象整合成一个datetime对象
datetime.strptime(date_str, format)	将时间字符串转换为datetime对象

对象方法和属性

对象方法/属性名称	描述
dt.year, dt.month, dt.day	年、月、日
dt.hour, dt.minute, dt.second	时、分、秒
dt.microsecond, dt.tzinfo	微秒、时区信息
dt.date()	获取datetime对象对应的date对象
dt.time()	获取datetime对象对应的time对象， tzinfo 为None
dt.timetz()	获取datetime对象对应的time对象，tzinfo与datetime对象的tzinfo相同
dt.replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]])	生成并返回一个新的datetime对象，如果所有参数都没有指定，则返回一个与原datetime对象相同的对象
dt.timetuple()	返回datetime对象对应的tuple（不包括tzinfo）
dt.utctimetuple()	返回datetime对象对应的utc时间的tuple（不包括tzinfo）
dt.toordinal()	同date对象
dt.weekday()	同date对象
dt.isocalendar()	同date独享
dt.isoformat([sep])	返回一个‘%Y-%m-%d
dt.ctime()	等价于time模块的time.ctime(time.mktime(d.timetuple()))
dt.strftime(format)	返回指定格式的时间字符串

实例

>>> from datetime import datetime, timezone
>>>
>>> datetime.today()
datetime.datetime(2017, 2, 4, 20, 44, 40, 556318)
>>> datetime.now()
datetime.datetime(2017, 2, 4, 20, 44, 56, 572615)
>>> datetime.now(timezone.utc)
datetime.datetime(2017, 2, 4, 12, 45, 22, 881694, tzinfo=datetime.timezone.utc)
>>> datetime.utcnow()
datetime.datetime(2017, 2, 4, 12, 45, 52, 812508)
>>> import time
>>> datetime.fromtimestamp(time.time())
datetime.datetime(2017, 2, 4, 20, 46, 41, 97578)
>>> datetime.utcfromtimestamp(time.time())
datetime.datetime(2017, 2, 4, 12, 46, 56, 989413)
>>> datetime.combine(date(2017, 2, 4), t)
datetime.datetime(2017, 2, 4, 20, 5, 40, 8888)
>>> datetime.strptime('2017/02/04 20:49', '%Y/%m/%d %H:%M')
datetime.datetime(2017, 2, 4, 20, 49)
>>> dt = datetime.now()
>>> dt
datetime.datetime(2017, 2, 4, 20, 57, 0, 621378)
>>> dt.year
2017
>>> dt.month
2
>>> dt.day
4
>>> dt.hour
20
>>> dt.minute
57
>>> dt.second
0
>>> dt.microsecond
621378
>>> dt.tzinfo
>>> dt.timestamp()
1486213020.621378
>>> dt.date()
datetime.date(2017, 2, 4)
>>> dt.time()
datetime.time(20, 57, 0, 621378)
>>> dt.timetz()
datetime.time(20, 57, 0, 621378)
>>> dt.replace()
datetime.datetime(2017, 2, 4, 20, 57, 0, 621378)
>>> dt.replace(2016)
datetime.datetime(2016, 2, 4, 20, 57, 0, 621378)
>>> dt.timetuple()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=20, tm_min=57, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> dt.utctimetuple()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=20, tm_min=57, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=0)
>>> dt.toordinal()
736364
>>> dt.weekday()
5
>>> dt.isocalendar()
(2017, 5, 6)
>>> dt.isoformat()
'2017-02-04T20:57:00.621378'
>>> dt.isoformat(sep='/')
'2017-02-04/20:57:00.621378'
>>> dt.isoformat(sep=' ')
'2017-02-04 20:57:00.621378'
>>> dt.ctime()
'Sat Feb 4 20:57:00 2017'
>>> dt.strftime('%Y%m%d %H:%M:%S.%f')
'20170204 20:57:00.621378'

6. 使用datetime.datetime类对时间戳与时间字符串进行转换

7. datetime.timedelta类

timedelta对象表示连个不同时间之间的差值。如果使用time模块对时间进行算术运行，只能将字符串格式的时间 和 struct_time格式的时间对象 先转换为时间戳格式，然后对该时间戳加上或减去n秒，最后再转换回struct_time格式或字符串格式，这显然很不方便。而datetime模块提供的timedelta类可以让我们很方面的对datetime.date, datetime.time和datetime.datetime对象做算术运算，且两个时间之间的差值单位也更加容易控制。
 这个差值的单位可以是：天、秒、微秒、毫秒、分钟、小时、周。

datetime.timedelta类的定义

代码如下:

class datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, hours=0, weeks=0)

所有参数都是默认参数，因此都是可选参数。参数的值可以是整数或浮点数，也可以是正数或负数。内部值存储days、seconds 和 microseconds，其他所有参数都将被转换成这3个单位：

• 1毫秒转换为1000微秒

• 1分钟转换为60秒

• 1小时转换为3600秒

• 1周转换为7天

然后对这3个值进行标准化，使得它们的表示是唯一的：

• microseconds : [0, 999999]

• seconds : [0, 86399]

• days : [-999999999, 999999999]

类属性

类属性名称	描述
timedelta.min	timedelta(-999999999)
timedelta.max	timedelta(days=999999999, hours=23, minutes=59, seconds=59, microseconds=999999)
timedelta.resolution	timedelta(microseconds=1)

实例方法和属性

实例方法/属性名称	描述
td.days	天 [-999999999, 999999999]
td.seconds	秒 [0, 86399]
td.microseconds	微秒 [0, 999999]
td.total_seconds()	时间差中包含的总秒数，等价于: td / timedelta(seconds=1)

方法/属性	描述
datetime.datetime.now()	返回当前本地时间（datetime.datetime对象实例）
datetime.datetime.fromtimestamp(timestamp)	返回指定时间戳对应的时间（datetime.datetime对象实例）
datetime.timedelta()	返回一个时间间隔对象，可以直接与datetime.datetime对象做加减操作

实例

>>> import datetime
>>>
>>> datetime.timedelta(365).total_seconds() # 一年包含的总秒数
31536000.0
>>> dt = datetime.datetime.now()
>>> dt + datetime.timedelta(3) # 3天后
datetime.datetime(2017, 2, 8, 9, 39, 40, 102821)
>>> dt + datetime.timedelta(-3) # 3天前
datetime.datetime(2017, 2, 2, 9, 39, 40, 102821)
>>> dt + datetime.timedelta(hours=3) # 3小时后
datetime.datetime(2017, 2, 5, 12, 39, 40, 102821)
>>> dt + datetime.timedelta(hours=-3) # 3小时前
datetime.datetime(2017, 2, 5, 6, 39, 40, 102821)
>>> dt + datetime.timedelta(hours=3, seconds=30) # 3小时30秒后 
datetime.datetime(2017, 2, 5, 12, 40, 10, 102821)

五、时间格式码

time模块的struct_time以及datetime模块的datetime、date、time类都提供了strftime()方法，该方法可 以输出一个指定格式的时间字符串。具体格式由一系列的格式码（格式字符）组成，Python最终调用的是各个平台C库的strftme()函数，因此各平台对全套格式码的支持会有所不同，具体情况需要参考该平台上的strftime(3)文档。下面列出了C标准（1989版）要求的所有格式码，它们在所有标准C实现的平台上都可以工作：

六、总结

那么Python中处理时间时，使用time模块好，还是用datetime模块好呢？就我个人而言，datetime模块基本上可以满足需要，且用起来确实比较方便。对于time模块，我只是在取当前时间的时间戳时会用到time.time()方法，当然也可以通过datetime.datetime.now().timestamp()来获取，只是显得复杂一点。我觉得还是看个人习惯吧，没有什么绝对的好坏之分。

【相关推荐】

1. Python免费视频教程

2. Python学习手册

3. Python面向对象视频教程

以上がPython の日時および日付モジュールの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。