arrow

Flecha: mejores fechas y horarios para Python

Arrow es una biblioteca de Python que ofrece un enfoque sensato y amigable para los humanos para crear, manipular, formatear y convertir fechas, horas y marcas de tiempo. Implementa y actualiza el tipo de fecha y hora, solucionando lagunas en la funcionalidad y proporcionando una API de módulo inteligente que admite muchos escenarios de creación comunes. En pocas palabras, le ayuda a trabajar con fechas y horas con menos importaciones y mucho menos código.

Arrow lleva el nombre de la flecha del tiempo y está fuertemente inspirada en moment.js y solicitudes.

¿Por qué utilizar Arrow en lugar de módulos integrados?

La biblioteca estándar de Python y algunos otros módulos de bajo nivel tienen una funcionalidad de fecha, hora y zona horaria casi completa, pero no funcionan muy bien desde una perspectiva de usabilidad:

• Demasiados módulos: fecha, hora, calendario, dateutil, pytz y más
• Demasiados tipos: fecha, hora, fechahora, tzinfo, timedelta, relateddelta, etc.
• Las conversiones de zonas horarias y marcas de tiempo son detalladas y desagradables
• La ingenuidad de la zona horaria es la norma
• Brechas en la funcionalidad: análisis ISO 8601, períodos de tiempo, humanización

Características

• Reemplazo directo y completamente implementado para fecha y hora
• Soporte para Python 3.8+
• Consciente de zona horaria y UTC de forma predeterminada
• Opciones de creación súper simples para muchos escenarios de entrada comunes
• método shift con soporte para compensaciones relativas, incluidas semanas
• Formatear y analizar cadenas automáticamente
• Amplio soporte para el estándar ISO 8601
• Conversión de zona horaria
• Soporte para objetos dateutil , pytz y ZoneInfo tzinfo
• Genera períodos de tiempo, rangos, pisos y techos para marcos de tiempo que van desde microsegundos hasta años
• Humanice las fechas y horas con una lista cada vez mayor de locales contribuidos
• Extensible para sus propios tipos derivados de Arrow
• Soporte completo para sugerencias tipográficas estilo PEP 484

Inicio rápido

Instalación

Para instalar Arrow, use pip o pipenv:

$ pip install -U arrow

Uso de ejemplo

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

Documentación

Para obtener la documentación completa, visite arrow.readthedocs.io.

Contribuyendo

Se aceptan contribuciones tanto para el código como para las localizaciones (agregar y actualizar configuraciones regionales). Comience familiarizándose con la biblioteca Arrow y sus funciones. Luego, comience a contribuir:

1. Encuentre un problema o característica para abordar en el rastreador de problemas. Los números marcados con la etiqueta "buen primer número" pueden ser un excelente lugar para comenzar.
2. Bifurque este repositorio en GitHub y comience a realizar cambios en una rama.
3. Agregue algunas pruebas para asegurarse de que el error se haya solucionado o que la función funcione como se esperaba.
4. Ejecute todo el conjunto de pruebas y comprobaciones de linting ejecutando uno de los siguientes comandos: tox && tox -e lint,docs (si tiene tox instalado) O make build39 && make test && make lint (si no tiene Python 3.9 instalado, reemplace build39 con la última versión de Python en su sistema).
5. ¿Enviar una solicitud de extracción y esperar comentarios?

Si tiene alguna pregunta en el camino, no dude en hacerla aquí.

Flecha de soporte

Open Collective es una plataforma de financiación en línea que proporciona herramientas para recaudar dinero y compartir sus finanzas con total transparencia. Es la plataforma elegida por personas y empresas para realizar donaciones únicas o recurrentes directamente al proyecto. Si está interesado en hacer una contribución financiera, visite el colectivo Arrow.