Manuel de référence du module Datetime en Python

Avant-propos

Python fournit plusieurs modules intégrés pour manipuler la date et l'heure, tels que le calendrier, l'heure et la date/heure. L'interface fournie par le module time est fondamentalement cohérente avec la bibliothèque standard C time.h. Par rapport au module time, l'interface du module datetime est plus intuitive et plus facile à appeler. Le module

définit deux constantes :

datetime.MINYEAR

datetime.MAXYEAR

Ces deux constantes représentent respectivement ce que datetime peut représenter Le minimum et année maximale. Parmi eux, MINYEAR = 1, MAXYEAR = 9999.

le module datetime définit les classes suivantes :

datetime.date : classe représentant la date. Les attributs couramment utilisés incluent l'année, le mois, le jour ;

datetime.time : une classe représentant l'heure. Les attributs couramment utilisés incluent l'heure, la minute, la seconde, la microseconde ;

datetime.datetime : représente la date et l'heure.

datetime.timedelta : représente l'intervalle de temps, c'est-à-dire la durée entre deux points temporels.

datetime.tzinfo : informations pertinentes liées au fuseau horaire.

Remarque : Les types d'objets répertoriés ci-dessus sont tous immuables.

classe date

classe date représente une date (composée de l'année, du mois, du jour), et son prototype est le suivant :

class datetime.date( année, mois, jour)

Description du paramètre : La plage de

année est [MINYEAR, MAXYEAR], c'est-à-dire [1, 9999] ;

le mois est [1, 12]. (Le mois commence à 1, pas à 0) ; La valeur maximale du

jour est déterminée en fonction des paramètres de l'année et du mois donnés. Par exemple, février dans une année bissextile compte 29 jours ; la classe

date définit certaines méthodes et attributs de classe couramment utilisés :

date.max, date.min : quels objets de date peut représenter des dates maximales et minimales ;

date.resolution : L'objet date représente la plus petite unité de date. C'est le paradis.

date.today() : renvoie un objet date représentant la date locale actuelle ;

date.fromtimestamp(timestamp) : renvoie un objet date basé sur l'horodatage donné

datetime.fromordinal(ordinal) : Convertir l'heure du calendrier grégorien en objet date ; (Calendrier grégorien : une méthode de représentation du calendrier, similaire au calendrier lunaire de notre pays, qui est couramment utilisée dans les pays occidentaux et ne sera pas discutée en détail ici.)

Exemple d'utilisation :

>>> datetime.date.max
datetime.date(9999, 12, 31)
>>> datetime.date.min
datetime.date(1, 1, 1)
>>> datetime.date.resolution
datetime.timedelta(1)
>>> datetime.date.today()
datetime.date(2016, 5, 12)
>>> datetime.date.fromtimestamp(time.time())
datetime.date(2016, 5, 12)

Méthodes et propriétés d'instance fournies par date :

date.year , date.month, date.day : année, mois, jour ;

date.replace(year,month, day) : génère un nouvel objet date, en remplaçant celui d'origine par l'année, le mois et le jour. spécifié par les paramètres Propriétés dans l'objet. (L'objet d'origine reste inchangé)

date.timetuple() : Renvoie l'objet time.struct_time correspondant à la date

date.toordinal() : Renvoie la date du Calendrier Grégorien correspondant à la date ; date;

date.weekday() : renvoie le jour de la semaine, si c'est lundi, renvoie 0 ; si c'est mardi, renvoie 1, et ainsi de suite ; jour de la semaine, si c'est lundi, renvoie 1 ; si c'est mardi, renvoie 2, et ainsi de suite

date.isocalendar() : renvoie un tuple au format (année, mois, jour) ; 🎜>

date.isoformat() : renvoie une chaîne au format 'AAAA-MM-JJ' ;

date.strftime(fmt) : chaîne de format personnalisé.

Exemple d'utilisation :

>>> today = datetime.date.today()
>>> today.year
2016
>>> today.month
5
>>> today.day
12
>>> tomorrow = today.replace(day=13)
>>> tomorrow
datetime.date(2016, 5, 13)
>>> tomorrow.timetuple()
time.struct_time(tm_year=2016, tm_mon=5, tm_mday=13, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=4, tm_yday=134, tm_isdst=-1)
>>> tomorrow.toordinal()
736097
>>> tomorrow.weekday()
4
>>> tomorrow.isoweekday()
5
>>> tomorrow.isocalendar()
(2016, 19, 5)
>>> tomorrow.isoformat()
'2016-05-13'
>>> tomorrow.strftime("%y-%m-%d")
'16-05-13'

opérateur simple surchargé de date :

date autorisée Ajouter, soustraire et comparer les dates :

date2 = date1 timedelta :

Date plus un intervalle, renvoie un nouvel objet date

date2 = date1 - timedelta :

Date séparée par intervalle, renvoie un nouvel objet date

timedelta = date1 - date2 :

Soustrait deux dates, renvoie un objet intervalle de temps

date1 < date2 :

pour comparer deux dates.

Exemple d'utilisation :

>>> now = datetime.date.today()
>>> now
datetime.date(2016, 5, 12)
>>> now += datetime.date.resolution
>>> now
datetime.date(2016, 5, 13)
>>> now -= datetime.date.resolution
>>> now
datetime.date(2016, 5, 12)
>>> now < datetime.date.max
True

Classe de temps

La classe de temps représente le temps (composé d'heures, de minutes, secondes et composé de microsecondes), son prototype est le suivant :

class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None)

paramètres Remarque : La plage de

heure est [0, 24), la plage de

minute est [0, 60), la plage de

seconde est [0, 60),

la plage de microsecondes est [0, 1000000),

tzinfo représente les informations de fuseau horaire.

Attributs de classe définis par la classe horaire :

time.min, time.max : le temps minimum et maximum que la classe horaire peut représenter. Parmi eux, time.min = time(0, 0, 0, 0), time.max = time(23, 59, 59, 999999)

time.resolution : la plus petite unité de temps, ici ; est de 1 microsecondes ;

Exemple d'utilisation :

>>> datetime.time.min
datetime.time(0, 0)
>>> datetime.time.max
datetime.time(23, 59, 59, 999999)
>>> datetime.time.resolution
datetime.timedelta(0, 0, 1)

Méthodes et propriétés d'instance fournies par la classe temporelle :

time.hour, time.minute, time.second, time.microsecond : heures, minutes, secondes, microsecondes

time.tzinfo : informations sur le fuseau horaire

time.replace ; ([ hour[, minute[, second[, microsecond[, tzinfo]]]]]) : Créez un nouvel objet temporel et remplacez les attributs de l'objet d'origine par les heures, minutes, secondes et microsecondes spécifiées par les paramètres ( l'objet d'origine reste inchangé);

time.isoformat() : renvoie une représentation sous forme de chaîne au format "HH:MM:SS"

time.strftime(fmt) : renvoie un Chaîne de format personnalisée.

Exemple d'utilisation :

>>> tm = datetime.time(18, 18, 18)
>>> tm.hour
18
>>> tm.minute
18
>>> tm.second
18
>>> tm.microsecond
0
>>> tm.tzinfo
>>> tm.isoformat()
'18:18:18'
>>> tm.replace(hour=20)
datetime.time(20, 18, 18)
>>> tm.strftime("%I:%M:%S %p")
'06:18:18 PM'

Les objets de la classe temporelle peuvent uniquement être comparés et ne peuvent pas être ajoutés ou soustraits.

classe datetime

datetime est une combinaison de date et d'heure, y compris toutes les informations de date et d'heure. Le prototype est le suivant :

各参数的含义与date、time的构造函数中的一样，要注意参数值的范围。

datetime类定义的类属性与方法：

datetime.min、datetime.max：datetime所能表示的最小值与最大值；

datetime.resolution：datetime最小单位；

datetime.today()：返回一个表示当前本地时间的datetime对象；

datetime.now([tz])：返回一个表示当前本地时间的datetime对象，如果提供了参数tz，则获取tz参数所指时区的本地时间；

datetime.utcnow()：返回一个当前utc时间的datetime对象；

datetime.fromtimestamp(timestamp[, tz])：根据时间戮创建一个datetime对象，参数tz指定时区信息；

datetime.utcfromtimestamp(timestamp)：根据时间戮创建一个datetime对象；

datetime.combine(date, time)：根据date和time，创建一个datetime对象；

datetime.strptime(date_string, format)：将格式字符串转换为datetime对象，data 与 time 类没有提供该方法。

使用示例：

>>> datetime.datetime.min
datetime.datetime(1, 1, 1, 0, 0)
>>> datetime.datetime.max
datetime.datetime(9999, 12, 31, 23, 59, 59, 999999)
>>> datetime.datetime.resolution
datetime.timedelta(0, 0, 1)
>>> print datetime.datetime.resolution
0:00:00.000001
>>> today = datetime.datetime.today()
>>> today
datetime.datetime(2016, 5, 12, 12, 46, 47, 246240)
>>> datetime.datetime.now()
datetime.datetime(2016, 5, 12, 12, 47, 9, 850643)
>>> datetime.datetime.utcnow()
datetime.datetime(2016, 5, 12, 4, 47, 42, 188124)
>>> datetime.datetime.fromtimestamp(time.time())
datetime.datetime(2016, 5, 12, 12, 48, 40, 459676)
>>> datetime.datetime.combine(datetime.date(1990, 10, 05), datetime.time(18, 18, 18))
datetime.datetime(1990, 10, 5, 18, 18, 18)
>>> datetime.datetime.strptime("2010-04-07 01:48:16.234000", "%Y-%m-%d %H:%M:%S .%f")
datetime.datetime(2010, 4, 7, 1, 48, 16, 234000)

datetime 的实例方法与属性

datetime类提供的实例方法与属性大部分功能与 date 和 time 类似，这里仅罗列方法名不再赘述：

datetime.year、month、day、hour、minute、second、microsecond、tzinfo：

datetime.date()：获取date对象；

datetime.time()：获取time对象；

datetime.replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]])：

**datetime.timetuple() **

**datetime.utctimetuple() **

datetime.toordinal()

datetime.weekday()

datetime.isocalendar()

datetime.isoformat([sep])

datetime.ctime()：返回一个日期时间的C格式字符串，等效于time.ctime(time.mktime(dt.timetuple()))；

datetime.strftime(format)

datetime 对象同样可以进行比较，或者相减返回一个时间间隔对象，或者日期时间加上一个间隔返回一个新的日期时间对象。

timedelta 类

datetime.timedelta 对象代表两个时间之间的的时间差，两个 date 或 datetime 对象相减时可以返回一个timedelta 对象。其原型如下：

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

   

所有参数可选，且默认都是0，参数的值可以是整数，浮点数，正数或负数。

内部只存储days，seconds，microseconds，其他参数的值会自动按如下规则抓转换：

1 millisecond（毫秒） 转换成 1000 microseconds（微秒）

1 minute 转换成 60 seconds

1 hour 转换成 3600 seconds

1 week转换成 7 days

三个参数的取值范围分别为：

0 <= microseconds < 1000000

0 <= seconds < 3600*24 (the number of seconds in one day)

-999999999 <= days <= 999999999

timedelta 类定义的类属性：

timedelta.min：时间间隔对象的最小值,即 timedelta(-999999999).

timedelta.max：时间间隔对象的最大值，即 timedelta(days=999999999, hours=23, minutes=59, seconds=59, microseconds=999999).

timedelta.resolution：时间间隔的最小单位,即 timedelta(microseconds=1).

使用示例：

>>> datetime.timedelta.min
datetime.timedelta(-999999999)
>>> datetime.timedelta.max
datetime.timedelta(999999999, 86399, 999999)
>>> datetime.timedelta.resolution
datetime.timedelta(0, 0, 1)
>>> print datetime.timedelta.resolution
0:00:00.000001

timedelta 实例方法

timedelta.total_seconds()：计算时间间隔的总秒数

使用示例：

>>> datetime.timedelta.resolution.total_seconds()
1e-06

格式字符串

datetime、date、time 都提供了 strftime() 方法，该方法接收一个格式字符串，输出日期时间的字符串表示。支持的转换格式如下：

%a星期的简写。如 星期三为Web
%A星期的全写。如 星期三为Wednesday
%b月份的简写。如4月份为Apr
%B月份的全写。如4月份为April
%c: 日期时间的字符串表示。（如： 04/07/10 10:43:39）
%d: 日在这个月中的天数（是这个月的第几天）
%f: 微秒（范围[0,999999]）
%H: 小时（24小时制，[0, 23]）
%I: 小时（12小时制，[0, 11]）
%j: 日在年中的天数 [001,366]（是当年的第几天）
%m: 月份（[01,12]）
%M: 分钟（[00,59]）
%p: AM或者PM
%S: 秒（范围为[00,61]，为什么不是[00, 59]，参考python手册~_~）
%U: 周在当年的周数当年的第几周），星期天作为周的第一天
%w: 今天在这周的天数，范围为[0, 6]，6表示星期天
%W: 周在当年的周数（是当年的第几周），星期一作为周的第一天
%x: 日期字符串（如：04/07/10）
%X: 时间字符串（如：10:43:39）
%y: 2个数字表示的年份
%Y: 4个数字表示的年份
%z: 与utc时间的间隔 （如果是本地时间，返回空字符串）
%Z: 时区名称（如果是本地时间，返回空字符串）
%%: %% => %

   

使用示例：

>>> dt = datetime.datetime.now()
>>> dt.strftime('%Y-%m-%d %H:%M:%S %f')
'2016-05-12 14:19:22 333943'
>>> dt.strftime('%y-%m-%d %I:%M:%S %p')
'16-05-12 02:19:22 PM'
>>> dt.strftime("%a")
'Thu'
>>> dt.strftime("%A")
'Thursday'
>>> dt.strftime("%b")
'May'
>>> dt.strftime("%B")
'May'
>>> dt.strftime("%c")
'Thu May 12 14:19:22 2016'
>>> dt.strftime("%x")
'05/12/16'
>>> dt.strftime("%X")
'14:19:22'
>>> dt.strftime("%w")
'4'
>>> dt.strftime("%j")
'133'
>>> dt.strftime("%u")
'4'
>>> dt.strftime("%U")
'19'

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流。

更多Python中datetime模块参考手册相关文章请关注PHP中文网！