DateTime 5.5

转换和比较方法

• timeTime()返回UTC日期/时间作为浮点数，使用Python time模块的格式。请注意，使用DateTime可以创建没有对time模块有意义的日期/时间值，在这种情况下将引发DateTimeError。DateTime对象的值通常必须在1970年1月1日（或您的本地机器纪元）和2038年1月之间，才能生成有效的time.time()样式值。

  >>> dt = DateTime('Mar 9, 1997 13:45:00 US/Eastern')
  >>> dt.timeTime()
  857933100.0
  

  >>> DateTime('2040/01/01 UTC').timeTime()
  2208988800.0
  

  >>> DateTime('1900/01/01 UTC').timeTime()
  -2208988800.0
  

• toZone(z)返回一个DateTime对象，其值表示为当前对象在指定时区中的表示

  >>> dt.toZone('UTC')
  DateTime('1997/03/09 18:45:00 UTC')
  

  >>> dt.toZone('UTC').equalTo(dt)
  True
  

• isFuture()返回true，如果此对象表示的日期/时间晚于调用时间

  >>> dt.isFuture()
  False
  >>> DateTime('Jan 1 3000').isFuture() # not time-machine safe!
  True
  

• isPast()返回true，如果此对象表示的日期/时间早于调用时间

  >>> dt.isPast()
  True
  >>> DateTime('Jan 1 3000').isPast() # not time-machine safe!
  False
  

• isCurrentYear()返回true，如果此对象表示的日期/时间在当前对象时区表示的当前年份内

  >>> dt.isCurrentYear()
  False
  >>> DateTime().isCurrentYear()
  True
  

• isCurrentMonth()返回true，如果此对象表示的日期/时间在当前对象时区表示的当前月份内

  >>> dt.isCurrentMonth()
  False
  >>> DateTime().isCurrentMonth()
  True
  

• isCurrentDay()返回true，如果此对象表示的日期/时间在当前对象时区表示的当前天内

  >>> dt.isCurrentDay()
  False
  >>> DateTime().isCurrentDay()
  True
  

• isCurrentHour()返回true，如果此对象表示的日期/时间在当前对象时区表示的当前小时内

  >>> dt.isCurrentHour()
  False
  

  >>> DateTime().isCurrentHour()
  True
  

• isCurrentMinute()返回true，如果此对象表示的日期/时间在当前对象时区表示的当前分钟内

  >>> dt.isCurrentMinute()
  False
  >>> DateTime().isCurrentMinute()
  True
  

• isLeapYear()返回true，如果当前年份（在对象时区范围内）是闰年

  >>> dt.isLeapYear()
  False
  >>> DateTime('Mar 8 2004').isLeapYear()
  True
  

• earliestTime()返回一个新DateTime对象，表示当前对象时区范围内当前天最早可能的整秒时间

  earliest possible time (in whole seconds) that still falls within the current object’s day, in the object’s timezone context

  >>> dt.earliestTime()
  DateTime('1997/03/09 00:00:00 US/Eastern')
  

• latestTime()返回一个新DateTime对象，表示当前对象时区范围内当前天最晚可能的整秒时间

  >>> dt.latestTime()
  DateTime('1997/03/09 23:59:59 US/Eastern')
  

组件访问

• parts()返回一个包含对象日历年、月份、日期、小时、分钟、秒和时区的元组

  >>> dt.parts() # doctest: +ELLIPSIS
  (1997, 3, 9, 13, 45, ... 'US/Eastern')
  

• timezone()返回对象所表示的时区

  >>> dt.timezone() in Timezones()
  True
  

• tzoffset()返回对象的时区偏移量

  >>> dt.tzoffset()
  -18000
  

• year()返回对象的日历年

  >>> dt.year()
  1997
  

• month()返回对象的月份作为整数

  >>> dt.month()
  3
  

• Month()返回完整的月份名称

  >>> dt.Month()
  'March'
  

• aMonth()返回缩写的月份名称

  >>> dt.aMonth()
  'Mar'
  

• pMonth() 返回带点的缩写月份名称

  >>> dt.pMonth()
  'Mar.'
  

• day() 返回整数天数

  >>> dt.day()
  9
  

• Day() 返回星期几的完整名称

  >>> dt.Day()
  'Sunday'
  

• dayOfYear() 返回年份中的天数，针对对象的时区表示

  >>> dt.dayOfYear()
  68
  

• aDay() 返回星期几的缩写名称

  >>> dt.aDay()
  'Sun'
  

• pDay() 返回带点的星期几缩写名称

  >>> dt.pDay()
  'Sun.'
  

• dow() 返回星期几的整数，其中星期日为0

  >>> dt.dow()
  0
  

• dow_1() 返回星期几的整数，其中星期日为1

  >>> dt.dow_1()
  1
  

• h_12() 返回12小时制的时钟小时表示

  >>> dt.h_12()
  1
  

• h_24() 返回24小时制的时钟小时表示

  >>> dt.h_24()
  13
  

• ampm() 返回适当的时间修饰符（上午或下午）

  >>> dt.ampm()
  'pm'
  

• hour() 返回24小时制的时钟小时表示

  >>> dt.hour()
  13
  

• minute() 返回分钟

  >>> dt.minute()
  45
  

• second() 返回秒

  >>> dt.second() == 0
  True
  

• millis() 返回GMT以来纪元的毫秒数

  >>> dt.millis() == 857933100000
  True
  

strftime()

请参阅 tests/test_datetime.py.

从之前的DateTime获取的通用格式

• Date() 返回对象的日期字符串

  >>> dt.Date()
  '1997/03/09'
  

• Time() 返回对象的时间字符串，精确到秒

  >>> dt.Time()
  '13:45:00'
  

• TimeMinutes() 返回对象的时间字符串，不显示秒

  >>> dt.TimeMinutes()
  '13:45'
  

• AMPM() 返回对象的时间字符串，精确到秒

  >>> dt.AMPM()
  '01:45:00 pm'
  

• AMPMMinutes() 返回对象的时间字符串，不显示秒

  >>> dt.AMPMMinutes()
  '01:45 pm'
  

• PreciseTime() 返回对象的时间字符串

  >>> dt.PreciseTime()
  '13:45:00.000'
  

• PreciseAMPM() 返回对象的时间字符串

  >>> dt.PreciseAMPM()
  '01:45:00.000 pm'
  

• yy() 返回2位数字的日历年份

  >>> dt.yy()
  '97'
  

• mm() 返回2位数字的月份

  >>> dt.mm()
  '03'
  

• dd() 返回2位数字的天数

  >>> dt.dd()
  '09'
  

• rfc822() 返回RFC 822格式的日期

  >>> dt.rfc822()
  'Sun, 09 Mar 1997 13:45:00 -0500'
  

新格式

• fCommon() 返回表示对象值的字符串，格式为：1997年3月9日 1:45 pm

  >>> dt.fCommon()
  'March 9, 1997 1:45 pm'
  

• fCommonZ() 返回表示对象值的字符串，格式为：1997年3月9日 1:45 pm US/Eastern

  >>> dt.fCommonZ()
  'March 9, 1997 1:45 pm US/Eastern'
  

• aCommon() 返回表示对象值的字符串，格式为：Mar 9, 1997 1:45 pm

  >>> dt.aCommon()
  'Mar 9, 1997 1:45 pm'
  

• aCommonZ() 返回表示对象值的字符串，格式为：Mar 9, 1997 1:45 pm US/Eastern

  >>> dt.aCommonZ()
  'Mar 9, 1997 1:45 pm US/Eastern'
  

• pCommon() 返回表示对象值的字符串，格式为：Mar. 9, 1997 1:45 pm

  >>> dt.pCommon()
  'Mar. 9, 1997 1:45 pm'
  

• pCommonZ() 返回表示对象值的字符串，格式为：Mar. 9, 1997 1:45 pm US/Eastern

  >>> dt.pCommonZ()
  'Mar. 9, 1997 1:45 pm US/Eastern'
  

• ISO() 返回ISO格式的日期/时间字符串。注意：这不是ISO 8601格式！有关ISO 8601兼容的输出，请参阅下面的ISO8601和HTML4方法。日期输出为：YYYY-MM-DD HH:MM:SS

  >>> dt.ISO()
  '1997-03-09 13:45:00'
  

• ISO8601() 返回ISO 8601兼容格式的对象，包含日期、带有秒精度的日期和时间以及时区标识符 - 请参阅 http://www.w3.org/TR/NOTE-datetime。日期输出为：YYYY-MM-DDTHH:MM:SSTZD（T是字面字符，TZD是时区设计符，格式为+HH:MM或-HH:MM）。

  下面的 HTML4() 方法提供相同的格式，但在返回值之前将其转换为UTC，并设置TZD为“Z”

  >>> dt.ISO8601()
  '1997-03-09T13:45:00-05:00'
  

• HTML4() 返回的格式符合 HTML4.0 规范，是 ISO8601 的标准形式之一。详见 http://www.w3.org/TR/NOTE-datetime。日期输出格式为：YYYY-MM-DDTHH:MM:SSZ（T，Z为文字字符，时间以 UTC 为准。）

  >>> dt.HTML4()
  '1997-03-09T18:45:00Z'
  

• JulianDay() 返回根据 http://www.tondering.dk/claus/cal/node3.html#sec-calcjd 的儒略日。

  >>> dt.JulianDay()
  2450517
  

• week() 返回按照 ISO 计算的周数。详见 http://www.tondering.dk/claus/cal/node6.html#SECTION00670000000000000000

  >>> dt.week()
  10
  

已弃用的API

• DayOfWeek(): see Day()

• Day_(): see pDay()

• Mon(): see aMonth()

• Mon_(): see pMonth

DateTime提供的通用服务

DateTime 对象可以被 repr() 表示；结果将是一个字符串，表示如何创建与这个 DateTime 对象相似的 DateTime 对象

>>> repr(dt)
"DateTime('1997/03/09 13:45:00 US/Eastern')"

当我们把它们转换成字符串时，我们会得到一个更易读的字符串，实际上可以展示给用户

>>> str(dt)
'1997/03/09 13:45:00 US/Eastern'

DateTime 的哈希值基于日期和时间，对于 DateTime 的不同表示形式是相同的

>>> hash(dt)
3618678
>>> hash(dt.toZone('UTC'))
3618678

DateTime 对象可以使用 equalTo 方法与其他 DateTime 对象或浮点数（如 Python time 模块返回的浮点数）进行比较。使用此 API，如果对象表示的日期/时间等于指定的 DateTime 或 time 模块样式的时间，则返回 True

>>> dt.equalTo(dt)
True
>>> dt.equalTo(dt.toZone('UTC'))
True
>>> dt.equalTo(dt.timeTime())
True
>>> dt.equalTo(DateTime())
False

不等式也是如此

>>> dt.notEqualTo(dt)
False
>>> dt.notEqualTo(dt.toZone('UTC'))
False
>>> dt.notEqualTo(dt.timeTime())
False
>>> dt.notEqualTo(DateTime())
True

常规的相等运算仅适用于 DateTime 对象，并考虑时区设置

>>> dt == dt
True
>>> dt == dt.toZone('UTC')
False
>>> dt == DateTime()
False

>>> dt != dt
False
>>> dt != dt.toZone('UTC')
True
>>> dt != DateTime()
True

但其他比较操作比较的是参考时间点，而不是表示本身

>>> dt > dt
False
>>> DateTime() > dt
True
>>> dt > DateTime().timeTime()
False
>>> DateTime().timeTime() > dt
True

>>> dt.greaterThan(dt)
False
>>> DateTime().greaterThan(dt)
True
>>> dt.greaterThan(DateTime().timeTime())
False

>>> dt >= dt
True
>>> DateTime() >= dt
True
>>> dt >= DateTime().timeTime()
False
>>> DateTime().timeTime() >= dt
True

>>> dt.greaterThanEqualTo(dt)
True
>>> DateTime().greaterThanEqualTo(dt)
True
>>> dt.greaterThanEqualTo(DateTime().timeTime())
False

>>> dt < dt
False
>>> DateTime() < dt
False
>>> dt < DateTime().timeTime()
True
>>> DateTime().timeTime() < dt
False

>>> dt.lessThan(dt)
False
>>> DateTime().lessThan(dt)
False
>>> dt.lessThan(DateTime().timeTime())
True

>>> dt <= dt
True
>>> DateTime() <= dt
False
>>> dt <= DateTime().timeTime()
True
>>> DateTime().timeTime() <= dt
False

>>> dt.lessThanEqualTo(dt)
True
>>> DateTime().lessThanEqualTo(dt)
False
>>> dt.lessThanEqualTo(DateTime().timeTime())
True

DateTime提供的数值服务

DateTime 可以加到一个数字上，一个数字也可以加到 DateTime 上

>>> dt + 5
DateTime('1997/03/14 13:45:00 US/Eastern')
>>> 5 + dt
DateTime('1997/03/14 13:45:00 US/Eastern')

两个 DateTime 不能相加

>>> from DateTime.interfaces import DateTimeError
>>> try:
...     dt + dt
...     print('fail')
... except DateTimeError:
...     print('ok')
ok

可以从 DateTime 中减去一个数字，或者从一个数字中减去一个 DateTime，但是不能从一个数字中减去一个 DateTime

>>> DateTime('1997/03/10 13:45 US/Eastern') - dt
1.0
>>> dt - 1
DateTime('1997/03/08 13:45:00 US/Eastern')
>>> 1 - dt
Traceback (most recent call last):
...
TypeError: unsupported operand type(s) for -: 'int' and 'DateTime'

DateTime 也可以转换为整数（自纪元以来的秒数）和浮点数

>>> int(dt)
857933100
>>> float(dt)
857933100.0

DateTime 3的向下兼容性

DateTime 3更改了pickle表示形式。使用DateTime旧版本pickle的DateTime实例可以读取，但旧版本的DateTime无法读取使用版本3 pickle的DateTime实例。

DateTime 3将DateTime更改为具有插槽的新式类，而不是旧式类。

DateTime 3在其API的大部分内容中尝试保留微秒分辨率，而旧版本通常只能达到毫秒分辨率。由于Python 2.7之前的Python版本中浮点值的表示方式，如果您想获得高精度，则不应比较DateTime实例的字符串或浮点表示。同样适用于由 timeTime() 等方法返回的计算值。通过调用其 micros() 方法可以获得DateTime值的最高精度。DateTime不太适合用于比较文件系统的时间戳 - 请使用Python标准库中的time和datetime对象。