{"id":13399966,"url":"https://github.com/arrow-py/arrow","last_synced_at":"2025-12-12T01:05:49.995Z","repository":{"id":5546838,"uuid":"6750871","full_name":"arrow-py/arrow","owner":"arrow-py","description":"🏹 Better dates \u0026 times for Python","archived":false,"fork":false,"pushed_at":"2024-11-20T05:42:05.000Z","size":2320,"stargazers_count":8841,"open_issues_count":109,"forks_count":693,"subscribers_count":135,"default_branch":"master","last_synced_at":"2025-05-05T15:49:56.787Z","etag":null,"topics":["arrow","date","datetime","hacktoberfest","python","time","timestamp","timezones"],"latest_commit_sha":null,"homepage":"https://arrow.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arrow-py.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"open_collective":"arrow"}},"created_at":"2012-11-18T20:23:27.000Z","updated_at":"2025-05-02T18:06:52.000Z","dependencies_parsed_at":"2023-11-11T21:36:02.975Z","dependency_job_id":"0ce771fc-84a5-4a80-8e4b-0497f55537f0","html_url":"https://github.com/arrow-py/arrow","commit_stats":{"total_commits":1104,"total_committers":292,"mean_commits":3.780821917808219,"dds":0.8713768115942029,"last_synced_commit":"016fb9eb9b3835bcd4efc69dc048a0436bd7bfec"},"previous_names":["crsmithdev/arrow"],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arrow-py%2Farrow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arrow-py%2Farrow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arrow-py%2Farrow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arrow-py%2Farrow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arrow-py","download_url":"https://codeload.github.com/arrow-py/arrow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252631406,"owners_count":21779428,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arrow","date","datetime","hacktoberfest","python","time","timestamp","timezones"],"created_at":"2024-07-30T19:00:45.767Z","updated_at":"2025-12-12T01:05:44.960Z","avatar_url":"https://github.com/arrow-py.png","language":"Python","readme":"Arrow: Better dates \u0026 times for Python\n======================================\n\n.. start-inclusion-marker-do-not-remove\n\n.. image:: https://github.com/arrow-py/arrow/workflows/tests/badge.svg?branch=master\n   :alt: Build Status\n   :target: https://github.com/arrow-py/arrow/actions?query=workflow%3Atests+branch%3Amaster\n\n.. image:: https://codecov.io/gh/arrow-py/arrow/branch/master/graph/badge.svg\n   :alt: Coverage\n   :target: https://codecov.io/gh/arrow-py/arrow\n\n.. image:: https://img.shields.io/pypi/v/arrow.svg\n   :alt: PyPI Version\n   :target: https://pypi.python.org/pypi/arrow\n\n.. image:: https://img.shields.io/pypi/pyversions/arrow.svg\n   :alt: Supported Python Versions\n   :target: https://pypi.python.org/pypi/arrow\n\n.. image:: https://img.shields.io/pypi/l/arrow.svg\n   :alt: License\n   :target: https://pypi.python.org/pypi/arrow\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n   :alt: Code Style: Black\n   :target: https://github.com/psf/black\n\n\n**Arrow** is a Python library that offers a sensible and 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 providing 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 named after the `arrow of time \u003chttps://en.wikipedia.org/wiki/Arrow_of_time\u003e`_ and is heavily inspired by `moment.js \u003chttps://github.com/moment/moment\u003e`_ and `requests \u003chttps://github.com/psf/requests\u003e`_.\n\nWhy use Arrow over built-in modules?\n------------------------------------\n\nPython's standard library and some other low-level modules have near-complete date, time and timezone 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- Timezones and timestamp conversions are verbose and unpleasant\n- Timezone naivety 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- Support for Python 3.8+\n- Timezone-aware and UTC by default\n- Super-simple creation options for many common input scenarios\n- ``shift`` method with support for relative offsets, including weeks\n- Format and parse strings automatically\n- Wide support for the `ISO 8601 \u003chttps://en.wikipedia.org/wiki/ISO_8601\u003e`_ standard\n- Timezone conversion\n- Support for ``dateutil``, ``pytz``, and ``ZoneInfo`` tzinfo objects\n- Generates time spans, ranges, floors and ceilings for time frames ranging from microsecond to year\n- Humanize dates and times with a growing list of contributed locales\n- Extensible for your own Arrow-derived types\n- Full support for PEP 484-style type hints\n\nQuick Start\n-----------\n\nInstallation\n~~~~~~~~~~~~\n\nTo install Arrow, use `pip \u003chttps://pip.pypa.io/en/stable/quickstart/\u003e`_ or `pipenv \u003chttps://docs.pipenv.org\u003e`_:\n\n.. code-block:: console\n\n    $ pip install -U arrow\n\nExample Usage\n~~~~~~~~~~~~~\n\n.. code-block:: python\n\n    \u003e\u003e\u003e import arrow\n    \u003e\u003e\u003e arrow.get('2013-05-11T21:23:58.970460+07:00')\n    \u003cArrow [2013-05-11T21:23:58.970460+07:00]\u003e\n\n    \u003e\u003e\u003e utc = arrow.utcnow()\n    \u003e\u003e\u003e utc\n    \u003cArrow [2013-05-11T21:23:58.970460+00:00]\u003e\n\n    \u003e\u003e\u003e utc = utc.shift(hours=-1)\n    \u003e\u003e\u003e utc\n    \u003cArrow [2013-05-11T20:23:58.970460+00:00]\u003e\n\n    \u003e\u003e\u003e local = utc.to('US/Pacific')\n    \u003e\u003e\u003e local\n    \u003cArrow [2013-05-11T13:23:58.970460-07:00]\u003e\n\n    \u003e\u003e\u003e local.timestamp()\n    1368303838.970460\n\n    \u003e\u003e\u003e local.format()\n    '2013-05-11 13:23:58 -07:00'\n\n    \u003e\u003e\u003e local.format('YYYY-MM-DD HH:mm:ss ZZ')\n    '2013-05-11 13:23:58 -07:00'\n\n    \u003e\u003e\u003e local.humanize()\n    'an hour ago'\n\n    \u003e\u003e\u003e local.humanize(locale='ko-kr')\n    '한시간 전'\n\n.. end-inclusion-marker-do-not-remove\n\nDocumentation\n-------------\n\nFor full documentation, please visit `arrow.readthedocs.io \u003chttps://arrow.readthedocs.io\u003e`_.\n\nContributing\n------------\n\nContributions are welcome for both code and localizations (adding and updating locales). Begin by gaining familiarity with the Arrow library and its features. Then, jump into contributing:\n\n#. Find an issue or feature to tackle on the `issue tracker \u003chttps://github.com/arrow-py/arrow/issues\u003e`_. Issues marked with the `\"good first issue\" label \u003chttps://github.com/arrow-py/arrow/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22\u003e`_ may be a great place to start!\n#. Fork `this repository \u003chttps://github.com/arrow-py/arrow\u003e`_ on GitHub and begin making changes in a branch.\n#. Add a few tests to ensure that the bug was fixed or the feature works as expected.\n#. Run the entire test suite and linting checks by running one of the following commands: ``tox \u0026\u0026 tox -e lint,docs`` (if you have `tox \u003chttps://tox.readthedocs.io\u003e`_ installed) **OR** ``make build39 \u0026\u0026 make test \u0026\u0026 make lint`` (if you do not have Python 3.9 installed, replace ``build39`` with the latest Python version on your system).\n#. Submit a pull request and await feedback 😃.\n\nIf you have any questions along the way, feel free to ask them `here \u003chttps://github.com/arrow-py/arrow/discussions\u003e`_.\n\nSupport Arrow\n-------------\n\n`Open Collective \u003chttps://opencollective.com/\u003e`_ is an online funding platform that provides tools to raise money and share your finances with full transparency. It is the platform of choice for individuals and companies to make one-time or recurring donations directly to the project. If you are interested in making a financial contribution, please visit the `Arrow collective \u003chttps://opencollective.com/arrow\u003e`_.\n","funding_links":["https://opencollective.com/arrow","https://opencollective.com/"],"categories":["Python","HarmonyOS","📦 Packages","Data Format \u0026 I/O","日期和时间","Python 程序","🐍 Python","Date and Time","📚 فهرست","best open source projects for beginner","Date \u0026 Time Utilities"],"sub_categories":["Windows Manager","Python","For Python","网络服务_其他","Useful Python Tools for Data Analysis","کار با زمان و تقویم"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farrow-py%2Farrow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farrow-py%2Farrow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farrow-py%2Farrow/lists"}