Metadata-Version: 1.1
Name: pytime
Version: 0.1.2
Summary: A easy-use module to operate datetime by string
Home-page: https://github.com/shnode/PyTime
Author: Sinux
Author-email: nsinux@gmail.com
License: MIT
Description: PyTime
        ======
        
        |Build Status| |PyPI version| |Supported Python versions| |Supported
        Python implementations| |Coverage Status|
        
        PyTime is a easy-use Python module which aims to operate
        date/time/datetime by string.
        
        PyTime allows you using nonregular datetime string to generate and
        calculate datetime at most situation.
        
        It Also provides you some simple useful methods for getting datetime you
        want.
        
        Install
        -------
        
        ::
        
            pip install pytime
        
        Sample Usage
        ------------
        
        Calculate ``datetime`` all by string, accept unit for short or overall
        length, support out of order or in capital unit:
        
        ::
        
            >>>from pytime import pytime
            >>>
            >>>pytime.before('2015.5.17', '2years 3mon 3d 2hr' )     # 2years 3monhts 3days 2hours before 2015.5.17
            datetime.datetime(2013, 2, 13, 22, 0)
            >>>
            >>>pytime.after(pytime.tomorrow(), '23month3dy29minu')   # 23months 3days 29minutes after tomorrow
            datetime.datetime(2017, 4, 19, 0, 29)
        
        Parse nonregular datetime string to datetime stamp:
        
        ::
        
            >>>pytime.parse('2015517')
            datetime.date(2015, 5, 17)
            >>>
            >>>pytime.parse('5/17/15')
            datetime.date(2015, 5, 17)
            >>>
            >>>pytime.parse('92-11-2')
            datetime.date(1992, 11, 2)
        
        Get common festivals for designated year:
        
        ::
        
            >>>pytime.father()              # Father's Day
            datetime.date(2015, 6, 21)
            >>>
            >>>pytime.mother(2016)          # 2016 Mother's Day
            datetime.date(2016, 5, 8)
            >>>
            >>>pytime.easter(1999)          # 1999 Easter
            datetime.date(1999, 4, 4)
        
        Pytime support calculate timedelta by string even between ``date`` and
        ``datetime``, merely set the ``date`` to that day's midnight:
        
        ::
        
            >>>pytime.count('2015-5-17 23:23:23', pytime.tomorrow())
            datetime.timedelta(1, 84203)
        
        Get days between two date.
        
        ::
        
            >>>pytime.daysrange('2015-5-17', '2015-5-23')
            [datetime.date(2015, 5, 23),
             datetime.date(2015, 5, 22),
             datetime.date(2015, 5, 21),
             datetime.date(2015, 5, 20),
             datetime.date(2015, 5, 19),
             datetime.date(2015, 5, 18),
             datetime.date(2015, 5, 17)]
        
        ...
        
        and other useful methods for operate datetime easily.
        
        License
        -------
        
        MIT
        
        .. |Build Status| image:: https://travis-ci.org/shnode/PyTime.svg?branch=master
           :target: https://travis-ci.org/shnode/PyTime
        .. |PyPI version| image:: https://badge.fury.io/py/pytime.svg
           :target: http://badge.fury.io/py/pytime
        .. |Supported Python versions| image:: https://pypip.in/py_versions/pytime/badge.svg
           :target: https://pypi.python.org/pypi/pytime/
        .. |Supported Python implementations| image:: https://pypip.in/implementation/pytime/badge.svg
           :target: https://pypi.python.org/pypi/pytime/
        .. |Coverage Status| image:: https://coveralls.io/repos/shnode/PyTime/badge.svg
           :target: https://coveralls.io/r/shnode/PyTime
        
Keywords: datetime time datetime timeparser
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
