arrow

السهم: تواريخ وأوقات أفضل لبيثون

Arrow هي مكتبة Python تقدم طريقة معقولة وصديقة للإنسان لإنشاء التواريخ والأوقات والطوابع الزمنية ومعالجتها وتنسيقها وتحويلها. يقوم بتنفيذ وتحديث نوع التاريخ والوقت، وسد الفجوات في الوظائف وتوفير واجهة برمجة تطبيقات وحدة ذكية تدعم العديد من سيناريوهات الإنشاء الشائعة. ببساطة، فهو يساعدك على العمل مع التواريخ والأوقات مع عدد أقل من الواردات ورمز أقل بكثير.

تمت تسمية السهم على اسم سهم الزمن وهو مستوحى بشكل كبير من moment.js والطلبات.

لماذا نستخدم السهم على الوحدات المضمنة؟

تحتوي مكتبة بايثون القياسية وبعض الوحدات الأخرى ذات المستوى المنخفض على وظائف التاريخ والوقت والمنطقة الزمنية شبه الكاملة، ولكنها لا تعمل بشكل جيد من منظور سهولة الاستخدام:

• عدد كبير جدًا من الوحدات: التاريخ والوقت والتقويم والتاريخ والبيتز والمزيد
• أنواع كثيرة جدًا: التاريخ، والوقت، والوقت، وtzinfo، وtimedelta، وrelativedelta، وما إلى ذلك.
• المناطق الزمنية وتحويلات الطوابع الزمنية مطولة وغير سارة
• سذاجة المنطقة الزمنية هي القاعدة
• فجوات في الوظائف: تحليل ISO 8601، والفترات الزمنية، والإضفاء الطابع الإنساني

سمات

• تم تنفيذه بالكامل، واستبداله بالتاريخ والوقت
• دعم بايثون 3.8+
• علمًا بالمنطقة الزمنية والتوقيت العالمي المنسق (UTC) بشكل افتراضي
• خيارات إنشاء فائقة البساطة للعديد من سيناريوهات الإدخال الشائعة
• طريقة shift مع دعم الإزاحات النسبية، بما في ذلك الأسابيع
• تنسيق وتحليل السلاسل تلقائيًا
• دعم واسع لمعيار ISO 8601
• تحويل المنطقة الزمنية
• دعم كائنات dateutil و pytz و ZoneInfo tzinfo
• يولد فترات زمنية ونطاقات وأرضيات وأسقف لأطر زمنية تتراوح من ميكروثانية إلى سنة
• قم بإضفاء طابع إنساني على التواريخ والأوقات من خلال قائمة متزايدة من المواقع المساهمة
• قابلة للتوسيع للأنواع المشتقة من الأسهم الخاصة بك
• دعم كامل لتلميحات النوع PEP 484

بداية سريعة

تثبيت

لتثبيت Arrow، استخدم pip أو Pipenv:

$ 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 وميزاتها. ثم انتقل إلى المساهمة:

1. ابحث عن مشكلة أو ميزة لمعالجتها في أداة تعقب المشكلات. قد تكون المشكلات التي تحمل علامة "الإصدار الأول الجيد" مكانًا رائعًا للبدء!
2. قم بتفرع هذا المستودع على GitHub وابدأ في إجراء تغييرات على أحد الفروع.
3. أضف بعض الاختبارات للتأكد من إصلاح الخلل أو أن الميزة تعمل كما هو متوقع.
4. قم بتشغيل مجموعة الاختبار بأكملها وفحوصات الفحص عن طريق تشغيل أحد الأوامر التالية: tox && tox -e lint,docs (إذا كان لديك tox مثبتًا) أو make build39 && make test && make lint (إذا لم يكن لديك Python 3.9 مثبتًا، استبدل build39 بأحدث إصدار من Python على نظامك).
5. إرسال طلب سحب وانتظار ردود الفعل؟

إذا كانت لديك أي أسئلة على طول الطريق، فلا تتردد في طرحها هنا.

سهم الدعم

Open Collective عبارة عن منصة تمويل عبر الإنترنت توفر أدوات لجمع الأموال ومشاركة أموالك بشفافية كاملة. إنها المنصة المفضلة للأفراد والشركات لتقديم تبرعات لمرة واحدة أو متكررة مباشرة للمشروع. إذا كنت مهتمًا بتقديم مساهمة مالية، يرجى زيارة مجموعة Arrow الجماعية.