3
���h� � @ s> d Z ddlmZ ddlmZmZ d dd�Zdd� Zd d
� ZdS ) zs
This module offers general convenience and utility functions for dealing with
datetimes.
.. versionadded:: 2.7.0
� )�unicode_literals)�datetime�timeNc C s" t j| �}t j|j� td| d��S )a
Returns a :py:class:`datetime` representing the current day at midnight
:param tzinfo:
The time zone to attach (also used to determine the current day).
:return:
A :py:class:`datetime.datetime` object representing the current day
at midnight.
r )�tzinfo)r �now�combine�dater )r �dt� r
�9/tmp/pip-build-5_djhm0z/python-dateutil/dateutil/utils.py�today
s
r c C s | j dk r| S | j|d�S dS )a�
Sets the ``tzinfo`` parameter on naive datetimes only
This is useful for example when you are provided a datetime that may have
either an implicit or explicit time zone, such as when parsing a time zone
string.
.. doctest::
>>> from dateutil.tz import tzoffset
>>> from dateutil.parser import parse
>>> from dateutil.utils import default_tzinfo
>>> dflt_tz = tzoffset("EST", -18000)
>>> print(default_tzinfo(parse('2014-01-01 12:30 UTC'), dflt_tz))
2014-01-01 12:30:00+00:00
>>> print(default_tzinfo(parse('2014-01-01 12:30'), dflt_tz))
2014-01-01 12:30:00-05:00
:param dt:
The datetime on which to replace the time zone
:param tzinfo:
The :py:class:`datetime.tzinfo` subclass instance to assign to
``dt`` if (and only if) it is naive.
:return:
Returns an aware :py:class:`datetime.datetime`.
N)r )r �replace)r r r
r
r �default_tzinfo s
r c C s* t |�}| | }| | ko$|kS S )zn
Useful for comparing two datetimes that may have a negligible difference
to be considered equal.
)�abs)Zdt1Zdt2�delta�
differencer
r
r � within_delta@ s r )N)�__doc__�
__future__r r r r r r r
r
r
r �<module> s
# |