arrow下載 - arrow源碼下載

arrow

Python

Version 1.3.0

下載

Arrow：Python 更好的日期和時間

Arrow是一個 Python 函式庫，它提供了一個合理且人性化的方法來建立、操作、格式化和轉換日期、時間和時間戳記。它實現並更新了日期時間類型，填補了功能空白並提供了支援許多常見創建場景的智慧模組 API。簡而言之，它可以幫助您使用更少的導入和更少的程式碼來處理日期和時間。

Arrow 以時間之箭命名，深受 moment.js 和 requests 的啟發。

為什麼使用 Arrow 而不是內建模組？

Python 的標準函式庫和其他一些低階模組具有近乎完整的日期、時間和時區功能，但從可用性角度來看效果不佳：

模組太多：datetime、time、calendar、dateutil、pytz 等
類型太多：日期、時間、datetime、tzinfo、timedelta、relativedelta 等。
時區和時間戳轉換冗長且令人不快
時區天真是常態
功能差距：ISO 8601 解析、時間跨度、人性化

特徵

完全實現的日期時間直接替代品
支援Python 3.8+
預設時區感知和 UTC
適用於許多常見輸入場景的超級簡單建立選項
支援相對偏移（包括週）的shift方法
自動格式化和解析字串
對 ISO 8601 標準的廣泛支持
時區轉換
支援dateutil 、 pytz和ZoneInfo tzinfo 對象
產生從微秒到年的時間範圍的時間跨度、範圍、下限和上限
透過不斷增加的貢獻區域清單使日期和時間人性化
可擴展為您自己的 Arrow 派生類型
完全支援 PEP 484 風格的類型提示

快速入門

安裝

若要安裝 Arrow，請使用 pip 或 pipelinenv：

$ pip install -U arrow

用法範例

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

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

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

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

> >> local . timestamp ()
1368303838.970460

> >> 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' )
'한시간 전'

文件

如需完整文檔，請造訪 arrow.readthedocs.io。

貢獻

歡迎對程式碼和本地化（新增和更新語言環境）做出貢獻。首先熟悉 Arrow 函式庫及其功能。然後，開始貢獻：

在問題追蹤器上尋找要解決的問題或功能。標有“第一期好”標籤的問題可能是一個很好的起點！
在 GitHub 上分叉此儲存庫並開始在分支中進行變更。
添加一些測試以確保錯誤已修復或功能按預期工作。
透過執行以下命令之一來執行整個測試套件並進行 linting 檢查： tox && tox -e lint,docs （如果您安裝了 tox）或make build39 && make test && make lint （如果您沒有安裝 Python 3.9，將build39替換為系統上最新的Python 版本）。
提交拉取請求並等待回饋？

如果您在此過程中有任何疑問，請隨時在這裡提問。