radar 0.3

基本用法

>>> import radar
>>> radar.random_datetime()
datetime.datetime(2013, 5, 24, 16, 54, 52)

指定日期范围

您可以传递datetime.datetime或datetime.date对象

>>> import datetime
>>> import radar
>>> radar.random_date(
>>>     start = datetime.datetime(year=2000, month=5, day=24),
>>>     stop = datetime.datetime(year=2013, month=5, day=24)
>>> )
datetime.date(2012, 12, 31)

您也可以传递字符串

>>> radar.random_datetime(start='2012-05-24T00:00:00', stop='2013-05-24T23:59:59')
datetime.datetime(2013, 4, 18, 17, 54, 6)

生成随机时间

>>> radar.random_time(start='2012-01-01T00:00:00', stop='2012-01-01T23:59:59')
datetime.time(11, 33, 59)

高级用法

当传递字符串时，默认情况下，radar 使用 python-dateutil 包来解析日期。虽然 dateutil 包的日期解析器非常智能，但它相当庞大。作为替代方案，radar 包含自己的解析器 radar.utils.parse，它更轻量（比 dateutil 快约5倍）。

使用内置解析器

>>> radar.random_datetime(start='2012-05-24T00:00:00', stop='2013-05-24T23:59:59', parse=radar.utils.parse)
datetime.datetime(2012, 11, 10, 15, 43, 40)

内置解析器使用 radar.defaults.FORMATS 中指定的格式来解析日期。

>>> start = radar.utils.parse('2012-01-01')
datetime.datetime(2012, 1, 1, 0, 0)
>>> stop = radar.utils.parse('2013-01-01')
datetime.datetime(2013, 1, 1, 0, 0)

如果您想添加更多格式，请定义自己的格式并将其提供给内置解析器。

>>> MY_FORMATS = (
>>>     ("%d-%m-%YT%H:%M:%S", True),
>>>     ("%d-%m-%Y", False)
>>> )
>>>
>>> def my_parse(timestamp):
>>>     return radar.utils.parse(timestamp, formats=MY_FORMATS)
>>>
>>> radar.random_datetime(start='24-05-2012T00:00:00', stop='24-05-2013T23:59:59', parse=my_parse)
datetime.datetime(2012, 11, 10, 15, 43, 40)

一般说明

如果您在从字符串生成随机日期时预计会有非常奇怪的日期格式，您可能想考虑安装令人惊叹的 python-dateutil 包。

当生成数千个对象（使用 dateutil 或内置解析器）时，建议您传递日期范围作为 datetime.datetime 或 datetime.date 对象，而不是传递字符串（解析会花费时间）。

一个好例子

>>> start = radar.utils.parse('2000-01-01')
>>> stop = radar.utils.parse('2013-12-31')
>>> for i in xrange(1000000):
>>>     radar.random_datetime(start=start, stop=stop)

请参阅 https://bitbucket.org/barseghyanartur/radar/src （示例）目录以获取基准测试和更多示例。