datetime模块源码解读

datetime模块是基本日期和时间类型，提供了以简单和复杂的方式操作日期和时间的类．可以进行输出格式化操作．

我们提供的服务有：做网站、网站设计、微信公众号开发、网站优化、网站认证、东至ssl等。为数千家企事业单位解决了网站和推广的问题。提供周到的售前咨询和贴心的售后服务，是有科学管理、有技术的东至网站制作公司

日期和时间对象有两种:naive 和 aware　.
datetime并且time 对象具有可选的时区信息属性，tzinfo可以将其设置为抽象tzinfo类的子类的实例.

常量

datetime.MINYEAR: 一个date或一个datetime对象中允许的最小年份数。 MINYEAR是1.
datetime.MAXYEAR: 一个date或一个datetime对象中允许的最大年份数。 MAXYEAR是9999.

可用类的类型

class datetime.date
- 理想化的天真日期,属性: year，month，和 day。
class datetime.time
- 理想化的时间.属性: hour，minute，second，microsecond，和tzinfo.
class datetime.datetime
- 日期和时间的组合。属性：year，month， day，hour，minute，second，microsecond，和tzinfo。
class datetime.timedelta
- 表达两者之间的差异的持续时间date，time或datetime实例微秒的分辨率
class datetime.tzinfo
- 时区信息对象的抽象基类。这些由 datetime和和time类一起用于提供可定制的时间调整概念.
class datetime.timezone
- 将tzinfo抽象基类实现为与UTC的固定偏移量的类.

date类的类方法和类属性

一个date对象代表一个理想化的日历日期（年，月，日），当前的公历无限期延长两个方向。1年1月1日称为第1天，1年1月2日称为第2天

类方法:
- datetime.date(year, month, day) 参数是必需的,可以是整数．
- date.today() 返回今天的日期．
- date.fromtimestamp() 返回与POSIX时间戳对应的本地日期.
- date.fromordinal() 返回对应于公历格里高利序数的日期.
类属性:
- date.min属性: 表示最早的月日(1.1)
- date.max属性: 最晚的月日(12.31)
- date.resolution: 非相等日期对象之间可能存在的最小差异， timedelta(days=1)。
实例属性(只读):
- date.year 打印年份.
- date.month: 月份(1-12月)
- date.day: 给定年份的给定月份的1和之间的天数.

注意: 日期可以用作字典键。在布尔上下文中，所有date 对象都被认为是真的。

实例方法:

date.replace方法
date.replace(year = self.year，month = self.month，day = self.day): 返回具有相同值的日期.
date.timetuple():返回元组类型的本地时间.
date.toordinal(): 返回日期的公历序数.
date.weekday() 以星期为单位返回星期几.其中星期一为0，星期日为6．
date.isoweekday():以星期为单位返回星期几，星期一为1，星期日为7.
date.isocalendar():返回3元组(月份,周,工作日)
date.isoformat(): 返回表示ISO 8601格式的日期字符串'YYYY-MM-DD'.
date.str(): 对于日期d，str(d)相当于d.isoformat().
date.ctime() : 返回表示日期的字符串.
date.strftime(format): 返回表示日期的字符串，由显式格式字符串控制。引用小时，分钟或秒的格式代码将显示0值.
date.format(format):和date.strftie()相同.
计算事件天数

参考libdate.py文件.

timedelta对象

timedelta对象表示的持续时间,两个日期或时间之间的差.

class datetime.timedelta（days = 0，seconds = 0，microseconds = 0，milliseconds = 0，minutes = 0，hours = 0，weeks = 0

参数可以是整数,浮点数,正数或负数.

参数转换:

毫秒转换为1000微秒。
一分钟转换为60秒。
一小时转换为3600秒。
一周转换为7天

类属性:

timedelta.min : 负数的timedelta对象.
timedelta.max : 最大的timedelta对象.
timedelta.resolution : 非平等timedelta物体之间可能存在的最小差异.

实例属性

实例属性(只读)

days 介于-999999999和999999999之间.
seconds: 介于0和86399之间.
microseconds: 介于0和999999之间.

timedelta对象还支持使用date和datetime 对象进行某些添加和减少.
timedelta对象是可散列的(可用作字典键).

实例方法:
- timedelta.total_seconds(): 返回持续时间中包含的总秒数

datetime对象

包含来自所有信息的单个对象date的对象和time对象。

构造函数:
```
class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)
```
年，月，日参数是必需的。 tzinfo可以是None，或者是tzinfo子类的实例。其余参数可以是整数.

datetime对象的类方法

datetime.today(): 返回当前的本地日期时间.
datetime.now(tz = None): 返回当前的本地日期和时间.
datetime.utcnow(): 返回当前的UTC日期和时间.
datetime.fromtimestamp(timestamp，tz = None)：返回与POSIX时间戳对应的本地日期和时间.
datetime.utcfromtimestamp(timestamp): 返回与datetimePOSIX时间戳对应的UTC.
datetime.fromordinal(ordinal): 返回datetime相应的公历格里高利序数,其中第1年1月1日有序数1.
datetime.combine(date, time, tzinfo=self.tzinfo): 返回一个新datetime对象，其日期组件等于给定date对象，其时间组件等于给定time对象.
datetime.strptime(date_string, format): 返回datetime对应的date_string，根据格式解析.

datetime对象的类属性

datetime.min: 最早的datetime，日期和时间.
datetime.max: 最晚的datetime，日期和时间.
datetime.resolution: 非平等datetime物体之间可能存在的最小差异.

实例属性

实例属性(只读)

datetime.year: 年
datetime.month：　介于1到12之间．
datetime.day: 在给定年份的给定月份的1和之间的天数.
datetime.hour: 范围(24小时)
datetime.minute：60分钟.
datetime.second: 60秒.
datetime.microsecond: 1000000毫秒.
datetime.tzinfo: 该对象作为tzinfo参数传递给datetime构造函数.
datetime.fold: 用于消除重复间隔期间的偏移时间.

datetime对象可以用作字典键.

实例方法

datetime.date(): 返回年月日的对象.
datetime.time(): 以相同的小时,分钟,秒,微秒和折叠返回对象。折叠值被复制到返回的time对象．
datetime.timetz(): 返回time具有相同小时，分钟，秒，微秒，折叠和tzinfo属性的对象.

datetime.replace()

datetime.replace(year=self.year, month=self.month, day=self.day, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0)

返回具有相同属性的日期时间.

datetime.astimezone(tz=None): 返回datetime具有新tzinfo属性tz的对象，调整日期和时间数据.tz必须是tzinfo子类的实例.
datetime.utcoffset(): 如果tzinfo是None，则返回None，否则返回 self.tzinfo.utcoffset(self)，并在后者未返回时引发异常None，或者timedelta表示大小小于一天的整数分钟的对象.
datetime.dst(): 如果tzinfo是None，则返回None，否则返回 self.tzinfo.dst(self)，并在后者未返回时引发异常 None，或者timedelta表示大小小于一天的整数分钟的对象。
datetime.tzname(): 如果tzinfo是None，则返回None，否则返回 self.tzinfo.tzname(self)，如果后者不返回None或者是字符串对象，则引发异常.
datetime.timetuple():返回time.struct_time
datetime.utctimetuple():
datetime.toordinal(): 返回日期的格里高利序数.
datetime.timestamp(): 返回与datetime 实例对应的POSIX时间戳.该timestamp()方法使用该fold属性消除重复间隔期间的时间歧义.
datetime.weekday(): 以星期为单位返回星期几，其中星期一为0.
datetime.isoweekday(): 以星期为单位返回星期几，星期一为1.
datetime.isocalendar(): 返回3元组(年,星期编号,工作日)
datetime.isoformat(sep ='T'，timespec ='auto'): 返回表示ISO 8601格式的日期和时间的字符串.
datetime.str(): 相当于d.isoformat(' ')
datetime.ctime(): 返回表示日期和时间的字符串.
datetime.strftime(format): 返回表示日期和时间的字符串，由显式格式字符串控制.
datetime.format(format): 返回表示日期和时间的字符串，由显式格式字符串控制.

time对象

time对象表示一天中的时间,可以通过tzinfo对象调整.

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

类属性

time.min: 最早的时间.
time.max: 最新的时间.
time.resolution: 非相等time对象之间可能存在最小差异.

实例属性

实例属性(只读)

time.hour: 24小时.
time.minute: 60分钟
time.second: 60s
time.microsecond: 1000000
time.tzinfo: 该对象作为tzinfo参数传递给time构造函数
time.fold: 消除重复间隔期间的墙壁时间.

实例方法

time.replace方法
time.replace(hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0)
返回time具有相同值的a
time.isoformat（timespec ='auto'): 返回表示ISO 8601格式的时间的字符串.
time.strftime(format): 返回表示时间的字符串，由显式格式字符串控制.

timezone 对象

每一个实例，其中表示通过从UTC的固定偏移定义的时区.

class datetime.timezone(offset, name=None)
所述偏移参数必须被指定为timedelta 代表的本地时间和UTC之间的差对象

timezone.utcoffset(dt): 返回timezone构造实例时指定的固定值.

timezone.tzname(dt): 返回timezone构造实例时指定的固定值.

timezone.dst(dt): 返回None.

类属性：
timezone.utc
UTC时区，timezone(timedelta(0))。

format time结构化表示

%a : 简化星期名称
%A : 本地完整星期名称
%b : 本地简化月份名称
%B : 本地完整月份名称
%c : 本地相应的日期和时间表示.
%d : 一个月中的第几天(01-31)
%H : 一天中的第几个小时(24小时制,00-23)
%I : 第几个小时(12小时制,01-12)
%j : 一年中的第几天(001-366)
%m : 月份(01-12)
%M : 分钟数(00-59)
%p : 本地am或者pm的对应符.
%S : 秒(01-61)
%U : 一年中的星期数.(00-53星期天是一个星期的开始),第一个星期天之前的所有天数都放在第0周.
%w : 一个星期中的第几天(0-6,0是星期天)
%W : 和%U基本相同,不同的是%W以星期一为一个星期的开始.
%x : 本地相应日期.
%X : 本地相应时间.
%y : 去掉世纪的月份(00-99)
%Y : 完整月份.
%Z : 时区的名字(不存在就为空字符)
%% : '%'字符.

当前标题：datetime模块源码解读
文章源于：http://cdxtjz.cn/article/jcijoc.html

datetime模块源码解读

常量

可用类的类型

date类的类方法和类属性

实例方法:

timedelta对象

类属性:

实例属性

datetime对象

datetime对象的类方法

datetime对象的类属性

实例属性

实例方法

time对象

类属性

实例属性

实例方法

timezone 对象

format time结构化表示

其他资讯