arrow


Namearrow JSON
Version 0.10.0 PyPI version JSON
home_pagehttps://github.com/crsmithdev/arrow/
SummaryBetter dates and times for Python
upload_time2016-11-30 02:32:05
maintainer
docs_urlNone
authorChris Smith
requires_python
licenseApache 2.0
keywords
VCS
bugtrack_url
requirements python-dateutil nose nose-cov chai sphinx simplejson
Travis-CI
Coveralis test coverage
            Arrow - Better dates & times for Python
=======================================

.. image:: https://travis-ci.org/crsmithdev/arrow.svg
   :alt: build status
   :target: https://travis-ci.org/crsmithdev/arrow

.. image:: https://codecov.io/github/crsmithdev/arrow/coverage.svg?branch=master
   :target: https://codecov.io/github/crsmithdev/arrow
   :alt: Codecov

.. image:: https://img.shields.io/pypi/v/arrow.svg
   :target: https://pypi.python.org/pypi/arrow
   :alt: downloads
        
Documentation: `arrow.readthedocs.org <http://arrow.readthedocs.org/en/latest/>`_
---------------------------------------------------------------------------------

What?
-----

Arrow is a Python library that offers a sensible, human-friendly approach to creating, manipulating, formatting and converting dates, times, and timestamps.  It implements and updates the datetime type, plugging gaps in functionality, and provides an intelligent module API that supports many common creation scenarios.  Simply put, it helps you work with dates and times with fewer imports and a lot less code.

Arrow is heavily inspired by `moment.js <https://github.com/timrwood/moment>`_ and `requests <https://github.com/kennethreitz/requests>`_

Why?
----

Python's standard library and some other low-level modules have near-complete date, time and time zone functionality but don't work very well from a usability perspective:

- Too many modules:  datetime, time, calendar, dateutil, pytz and more
- Too many types:  date, time, datetime, tzinfo, timedelta, relativedelta, etc.
- Time zones and timestamp conversions are verbose and unpleasant 
- Time zone naievety is the norm
- Gaps in functionality:  ISO-8601 parsing, timespans, humanization

Features 
--------

- Fully implemented, drop-in replacement for datetime 
- Supports Python 2.6, 2.7, 3.3, 3.4 and 3.5
- Time zone-aware & UTC by default
- Provides super-simple creation options for many common input scenarios
- Updated .replace method with support for relative offsets, including weeks
- Formats and parses strings automatically
- Partial support for ISO-8601
- Timezone conversion
- Timestamp available as a property
- Generates time spans, ranges, floors and ceilings in timeframes from year to microsecond
- Humanizes and supports a growing list of contributed locales
- Extensible for your own Arrow-derived types

Quick start
-----------

First:

.. code-block:: console

    $ pip install arrow

And then:

.. code-block:: pycon

    >>> import arrow
    >>> utc = arrow.utcnow()
    >>> utc
    <Arrow [2013-05-11T21:23:58.970460+00:00]>

    >>> utc = utc.replace(hours=-1)
    >>> utc
    <Arrow [2013-05-11T20:23:58.970460+00:00]>

    >>> local = utc.to('US/Pacific')
    >>> local
    <Arrow [2013-05-11T13:23:58.970460-07:00]>

    >>> arrow.get('2013-05-11T21:23:58.970460+00:00')
    <Arrow [2013-05-11T21:23:58.970460+00:00]>

    >>> local.timestamp
    1368303838

    >>> local.format()
    '2013-05-11 13:23:58 -07:00'

    >>> local.format('YYYY-MM-DD HH:mm:ss ZZ')
    '2013-05-11 13:23:58 -07:00'

    >>> local.humanize()
    'an hour ago'

    >>> local.humanize(locale='ko_kr')
    '1시간 전'
    
Further documentation can be found at `arrow.readthedocs.org <http://arrow.readthedocs.org/en/latest/>`_

Contributing
------------

Contributions are welcome, especially with localization.  See `locales.py <https://github.com/crsmithdev/arrow/blob/master/arrow/locales.py>`_ for what's currently supported.

            

Raw data

            {
    "maintainer": "", 
    "docs_url": null, 
    "requires_python": "", 
    "maintainer_email": "", 
    "cheesecake_code_kwalitee_id": null, 
    "coveralis": true, 
    "keywords": "", 
    "tox": true, 
    "requirements": [
        {
            "name": "python-dateutil", 
            "specs": [
                [
                    "==", 
                    "2.1"
                ]
            ]
        }, 
        {
            "name": "nose", 
            "specs": [
                [
                    "==", 
                    "1.3.0"
                ]
            ]
        }, 
        {
            "name": "nose-cov", 
            "specs": [
                [
                    "==", 
                    "1.6"
                ]
            ]
        }, 
        {
            "name": "chai", 
            "specs": [
                [
                    "==", 
                    "0.4.8"
                ]
            ]
        }, 
        {
            "name": "sphinx", 
            "specs": [
                [
                    "==", 
                    "1.2b1"
                ]
            ]
        }, 
        {
            "name": "simplejson", 
            "specs": [
                [
                    "==", 
                    "3.6.5"
                ]
            ]
        }
    ], 
    "author": "Chris Smith", 
    "home_page": "https://github.com/crsmithdev/arrow/", 
    "github_user": "crsmithdev", 
    "download_url": "https://pypi.python.org/packages/54/db/76459c4dd3561bbe682619a5c576ff30c42e37c2e01900ed30a501957150/arrow-0.10.0.tar.gz", 
    "platform": "", 
    "version": "0.10.0", 
    "cheesecake_documentation_id": null, 
    "description": "Arrow - Better dates & times for Python\n=======================================\n\n.. image:: https://travis-ci.org/crsmithdev/arrow.svg\n   :alt: build status\n   :target: https://travis-ci.org/crsmithdev/arrow\n\n.. image:: https://codecov.io/github/crsmithdev/arrow/coverage.svg?branch=master\n   :target: https://codecov.io/github/crsmithdev/arrow\n   :alt: Codecov\n\n.. image:: https://img.shields.io/pypi/v/arrow.svg\n   :target: https://pypi.python.org/pypi/arrow\n   :alt: downloads\n        \nDocumentation: `arrow.readthedocs.org <http://arrow.readthedocs.org/en/latest/>`_\n---------------------------------------------------------------------------------\n\nWhat?\n-----\n\nArrow is a Python library that offers a sensible, human-friendly approach to creating, manipulating, formatting and converting dates, times, and timestamps.  It implements and updates the datetime type, plugging gaps in functionality, and provides an intelligent module API that supports many common creation scenarios.  Simply put, it helps you work with dates and times with fewer imports and a lot less code.\n\nArrow is heavily inspired by `moment.js <https://github.com/timrwood/moment>`_ and `requests <https://github.com/kennethreitz/requests>`_\n\nWhy?\n----\n\nPython's standard library and some other low-level modules have near-complete date, time and time zone functionality but don't work very well from a usability perspective:\n\n- Too many modules:  datetime, time, calendar, dateutil, pytz and more\n- Too many types:  date, time, datetime, tzinfo, timedelta, relativedelta, etc.\n- Time zones and timestamp conversions are verbose and unpleasant \n- Time zone naievety is the norm\n- Gaps in functionality:  ISO-8601 parsing, timespans, humanization\n\nFeatures \n--------\n\n- Fully implemented, drop-in replacement for datetime \n- Supports Python 2.6, 2.7, 3.3, 3.4 and 3.5\n- Time zone-aware & UTC by default\n- Provides super-simple creation options for many common input scenarios\n- Updated .replace method with support for relative offsets, including weeks\n- Formats and parses strings automatically\n- Partial support for ISO-8601\n- Timezone conversion\n- Timestamp available as a property\n- Generates time spans, ranges, floors and ceilings in timeframes from year to microsecond\n- Humanizes and supports a growing list of contributed locales\n- Extensible for your own Arrow-derived types\n\nQuick start\n-----------\n\nFirst:\n\n.. code-block:: console\n\n    $ pip install arrow\n\nAnd then:\n\n.. code-block:: pycon\n\n    >>> import arrow\n    >>> utc = arrow.utcnow()\n    >>> utc\n    <Arrow [2013-05-11T21:23:58.970460+00:00]>\n\n    >>> utc = utc.replace(hours=-1)\n    >>> utc\n    <Arrow [2013-05-11T20:23:58.970460+00:00]>\n\n    >>> local = utc.to('US/Pacific')\n    >>> local\n    <Arrow [2013-05-11T13:23:58.970460-07:00]>\n\n    >>> arrow.get('2013-05-11T21:23:58.970460+00:00')\n    <Arrow [2013-05-11T21:23:58.970460+00:00]>\n\n    >>> local.timestamp\n    1368303838\n\n    >>> local.format()\n    '2013-05-11 13:23:58 -07:00'\n\n    >>> local.format('YYYY-MM-DD HH:mm:ss ZZ')\n    '2013-05-11 13:23:58 -07:00'\n\n    >>> local.humanize()\n    'an hour ago'\n\n    >>> local.humanize(locale='ko_kr')\n    '1\uc2dc\uac04 \uc804'\n    \nFurther documentation can be found at `arrow.readthedocs.org <http://arrow.readthedocs.org/en/latest/>`_\n\nContributing\n------------\n\nContributions are welcome, especially with localization.  See `locales.py <https://github.com/crsmithdev/arrow/blob/master/arrow/locales.py>`_ for what's currently supported.\n", 
    "upload_time": "2016-11-30 02:32:05", 
    "lcname": "arrow", 
    "bugtrack_url": null, 
    "github": true, 
    "name": "arrow", 
    "license": "Apache 2.0", 
    "travis_ci": true, 
    "github_project": "arrow", 
    "summary": "Better dates and times for Python", 
    "split_keywords": [], 
    "author_email": "crsmithdev@gmail.com", 
    "urls": [
        {
            "has_sig": false, 
            "upload_time": "2016-11-30T02:32:05", 
            "comment_text": "", 
            "python_version": "source", 
            "url": "https://pypi.python.org/packages/54/db/76459c4dd3561bbe682619a5c576ff30c42e37c2e01900ed30a501957150/arrow-0.10.0.tar.gz", 
            "md5_digest": "5d00592200050ad58284d45a4ee147c6", 
            "downloads": 0, 
            "filename": "arrow-0.10.0.tar.gz", 
            "packagetype": "sdist", 
            "path": "54/db/76459c4dd3561bbe682619a5c576ff30c42e37c2e01900ed30a501957150/arrow-0.10.0.tar.gz", 
            "size": 86506
        }
    ], 
    "_id": null, 
    "cheesecake_installability_id": null
}