arrow

Arrow: Bessere Daten und Zeiten für Python

Arrow ist eine Python-Bibliothek, die einen sinnvollen und benutzerfreundlichen Ansatz zum Erstellen, Bearbeiten, Formatieren und Konvertieren von Datumsangaben, Uhrzeiten und Zeitstempeln bietet. Es implementiert und aktualisiert den datetime-Typ, schließt Funktionslücken und stellt eine intelligente Modul-API bereit, die viele gängige Erstellungsszenarien unterstützt. Einfach ausgedrückt hilft es Ihnen, mit Datums- und Uhrzeitangaben mit weniger Importen und viel weniger Code zu arbeiten.

Arrow ist nach dem Pfeil der Zeit benannt und stark von moment.js und Anfragen inspiriert.

Warum Arrow statt integrierter Module verwenden?

Die Standardbibliothek von Python und einige andere Low-Level-Module verfügen über nahezu vollständige Datums-, Uhrzeit- und Zeitzonenfunktionen, funktionieren jedoch aus Sicht der Benutzerfreundlichkeit nicht besonders gut:

• Zu viele Module: datetime, time, Calendar, dateutil, pytz und mehr
• Zu viele Typen: Datum, Uhrzeit, Datum/Uhrzeit, tzinfo, timedelta, relativedelta usw.
• Zeitzonen und Zeitstempelkonvertierungen sind ausführlich und unangenehm
• Zeitzonen-Naivität ist die Norm
• Lücken in der Funktionalität: ISO 8601-Analyse, Zeitspannen, Humanisierung

Merkmale

• Vollständig implementierter Drop-in-Ersatz für datetime
• Unterstützung für Python 3.8+
• Zeitzonenbewusst und standardmäßig UTC
• Supereinfache Erstellungsmöglichkeiten für viele gängige Eingabeszenarien
• shift mit Unterstützung für relative Offsets, einschließlich Wochen
• Formatieren und analysieren Sie Zeichenfolgen automatisch
• Breite Unterstützung für den ISO 8601-Standard
• Zeitzonenkonvertierung
• Unterstützung für dateutil , pytz und ZoneInfo tzinfo-Objekte
• Erzeugt Zeitspannen, Bereiche, Untergrenzen und Obergrenzen für Zeiträume von der Mikrosekunde bis zum Jahr
• Humanisieren Sie Datums- und Uhrzeitangaben mit einer wachsenden Liste an bereitgestellten Standorten
• Erweiterbar für Ihre eigenen von Arrow abgeleiteten Typen
• Volle Unterstützung für Typhinweise im PEP 484-Stil

Schnellstart

Installation

Um Arrow zu installieren, verwenden Sie pip oder pipenv:

$ pip install -U arrow

Beispielverwendung

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

Dokumentation

Die vollständige Dokumentation finden Sie unter Arrow.readthedocs.io.

Mitwirken

Beiträge sind sowohl für Code als auch für Lokalisierungen (Hinzufügen und Aktualisieren von Gebietsschemas) willkommen. Machen Sie sich zunächst mit der Arrow-Bibliothek und ihren Funktionen vertraut. Dann beginnen Sie mit der Mitarbeit:

1. Finden Sie im Issue-Tracker ein Problem oder eine Funktion, die Sie angehen möchten. Ausgaben, die mit dem Label „Gute Erstausgabe“ gekennzeichnet sind, können ein guter Ausgangspunkt sein!
2. Forken Sie dieses Repository auf GitHub und beginnen Sie, Änderungen in einem Zweig vorzunehmen.
3. Fügen Sie einige Tests hinzu, um sicherzustellen, dass der Fehler behoben wurde oder die Funktion wie erwartet funktioniert.
4. Führen Sie die gesamte Testsuite und Linting-Prüfungen aus, indem Sie einen der folgenden Befehle ausführen: tox && tox -e lint,docs (wenn Sie tox installiert haben) ODER make build39 && make test && make lint (wenn Sie Python 3.9 nicht installiert haben, Ersetzen Sie build39 durch die neueste Python-Version auf Ihrem System.
5. Senden Sie eine Pull-Anfrage und warten Sie auf Feedback?

Wenn Sie unterwegs Fragen haben, können Sie diese gerne hier stellen.

Unterstützungspfeil

Open Collective ist eine Online-Finanzierungsplattform, die Tools bietet, mit denen Sie Geld sammeln und Ihre Finanzen mit voller Transparenz teilen können. Es ist die Plattform der Wahl für Einzelpersonen und Unternehmen, um einmalige oder wiederkehrende Spenden direkt an das Projekt zu leisten. Wenn Sie Interesse an einer finanziellen Spende haben, besuchen Sie bitte das Arrow-Kollektiv.