comparison mercurial/thirdparty/zope/interface/common/idatetime.py @ 37178:68ee61822182

thirdparty: port zope.interface to relative imports

By using relative imports, we're guaranteed to get modules
vendored with Mercurial rather than other random modules
that might be in sys.path.

My editor strips trailing whitespace on save. So some minor
source code cleanup was also performed as part of this commit.

# no-check-commit because some modified lines have double newlines

Differential Revision: https://phab.mercurial-scm.org/D2930

37177:338367d44d34

##############################################################################
# Copyright (c) 2002 Zope Foundation and Contributors.
# All Rights Reserved.
# 
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS

This module is called idatetime because if it were called datetime the import
of the real datetime would fail.
"""

from zope.interface import Interface, Attribute
from zope.interface import classImplements

from datetime import timedelta, date, datetime, time, tzinfo


class ITimeDeltaClass(Interface):

    def replace(year, month, day):
        """Return a date with the same value.

        Except for those members given new values by whichever keyword
        arguments are specified. For example, if d == date(2002, 12, 31), then
        d.replace(day=26) == date(2000, 12, 26). 
        """

    def timetuple():
        """Return a 9-element tuple of the form returned by time.localtime().

    def utcnow():
        """Return the current UTC date and time, with tzinfo None.

        This is like now(), but returns the current UTC date and time, as a
        naive datetime object. 

        See also now().
        """

    def fromtimestamp(timestamp, tz=None):

        if tz models both standard and daylight time).

        If you merely want to attach a time zone object tz to a datetime dt
        without adjustment of date and time members, use dt.replace(tzinfo=tz).
        If you merely want to remove the time zone object from an aware
        datetime dt without conversion of date and time members, use 
        dt.replace(tzinfo=None).

        Note that the default tzinfo.fromutc() method can be overridden in a
        tzinfo subclass to effect the result returned by astimezone().
        """

37178:68ee61822182

##############################################################################
# Copyright (c) 2002 Zope Foundation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS

This module is called idatetime because if it were called datetime the import
of the real datetime would fail.
"""

from __future__ import absolute_import

from .. import Interface, Attribute
from .. import classImplements

from datetime import timedelta, date, datetime, time, tzinfo


class ITimeDeltaClass(Interface):

    def replace(year, month, day):
        """Return a date with the same value.

        Except for those members given new values by whichever keyword
        arguments are specified. For example, if d == date(2002, 12, 31), then
        d.replace(day=26) == date(2000, 12, 26).
        """

    def timetuple():
        """Return a 9-element tuple of the form returned by time.localtime().

    def utcnow():
        """Return the current UTC date and time, with tzinfo None.

        This is like now(), but returns the current UTC date and time, as a
        naive datetime object.

        See also now().
        """

    def fromtimestamp(timestamp, tz=None):

        if tz models both standard and daylight time).

        If you merely want to attach a time zone object tz to a datetime dt
        without adjustment of date and time members, use dt.replace(tzinfo=tz).
        If you merely want to remove the time zone object from an aware
        datetime dt without conversion of date and time members, use
        dt.replace(tzinfo=None).

        Note that the default tzinfo.fromutc() method can be overridden in a
        tzinfo subclass to effect the result returned by astimezone().
        """