arrow

Arrow : meilleures dates et heures pour Python

Arrow est une bibliothèque Python qui offre une approche sensée et conviviale pour créer, manipuler, formater et convertir des dates, des heures et des horodatages. Il implémente et met à jour le type datetime, comblant les lacunes dans les fonctionnalités et fournissant une API de module intelligente qui prend en charge de nombreux scénarios de création courants. En termes simples, cela vous aide à travailler avec des dates et des heures avec moins d'importations et beaucoup moins de code.

Arrow doit son nom à la flèche du temps et s'inspire fortement de moment.js et des requêtes.

Pourquoi utiliser Arrow plutôt que des modules intégrés ?

La bibliothèque standard de Python et certains autres modules de bas niveau ont des fonctionnalités de date, d'heure et de fuseau horaire presque complètes, mais ne fonctionnent pas très bien du point de vue de la convivialité :

• Trop de modules : datetime, time, calendrier, dateutil, pytz et plus
• Trop de types : date, heure, datetime, tzinfo, timedelta, relativedelta, etc.
• Les conversions de fuseaux horaires et d’horodatages sont verbeuses et désagréables
• La naïveté du fuseau horaire est la norme
• Lacunes dans les fonctionnalités : analyse ISO 8601, délais, humanisation

Caractéristiques

• Remplacement instantané et entièrement implémenté pour datetime
• Prise en charge de Python 3.8+
• Compatible avec le fuseau horaire et UTC par défaut
• Options de création ultra-simples pour de nombreux scénarios de saisie courants
• méthode shift avec prise en charge des décalages relatifs, y compris les semaines
• Formater et analyser automatiquement les chaînes
• Large prise en charge de la norme ISO 8601
• Conversion de fuseau horaire
• Prise en charge des objets dateutil , pytz et ZoneInfo tzinfo
• Génère des intervalles de temps, des plages, des planchers et des plafonds pour des périodes allant de la microseconde à l'année.
• Humanisez les dates et les heures avec une liste croissante de paramètres régionaux contribués
• Extensible pour vos propres types dérivés d'Arrow
• Prise en charge complète des astuces de type PEP 484

Démarrage rapide

Installation

Pour installer Arrow, utilisez pip ou pipenv :

$ pip install -U arrow

Exemple d'utilisation

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

Documentation

Pour une documentation complète, veuillez visiter arrow.readthedocs.io.

Contribuer

Les contributions sont les bienvenues pour le code et les localisations (ajout et mise à jour des paramètres régionaux). Commencez par vous familiariser avec la bibliothèque Arrow et ses fonctionnalités. Ensuite, lancez-vous dans la contribution :

1. Recherchez un problème ou une fonctionnalité à résoudre sur le système de suivi des problèmes. Les numéros marqués du label « bon premier numéro » peuvent être un excellent point de départ !
2. Forkez ce référentiel sur GitHub et commencez à apporter des modifications dans une branche.
3. Ajoutez quelques tests pour vous assurer que le bug a été corrigé ou que la fonctionnalité fonctionne comme prévu.
4. Exécutez l'intégralité de la suite de tests et les vérifications du linting en exécutant l'une des commandes suivantes : tox && tox -e lint,docs (si vous avez installé tox) OU make build39 && make test && make lint (si Python 3.9 n'est pas installé, remplacez build39 par la dernière version de Python sur votre système).
5. Soumettez une pull request et attendez des commentaires ?.

Si vous avez des questions en cours de route, n'hésitez pas à les poser ici.

Flèche de soutien

Open Collective est une plateforme de financement en ligne qui fournit des outils pour collecter des fonds et partager vos finances en toute transparence. C'est la plateforme de choix pour les particuliers et les entreprises pour faire des dons ponctuels ou récurrents directement au projet. Si vous êtes intéressé à apporter une contribution financière, veuillez visiter le collectif Arrow.