arrow

Panah: Tanggal & waktu yang lebih baik untuk Python

Arrow adalah pustaka Python yang menawarkan pendekatan yang masuk akal dan ramah manusia untuk membuat, memanipulasi, memformat, dan mengonversi tanggal, waktu, dan stempel waktu. Ini mengimplementasikan dan memperbarui tipe datetime, menutup kesenjangan dalam fungsionalitas dan menyediakan API modul cerdas yang mendukung banyak skenario pembuatan umum. Sederhananya, ini membantu Anda bekerja dengan tanggal dan waktu dengan lebih sedikit impor dan lebih sedikit kode.

Nama panah diambil dari nama panah waktu dan sangat terinspirasi oleh moment.js dan permintaan.

Mengapa menggunakan Arrow dibandingkan modul bawaan?

Pustaka standar Python dan beberapa modul tingkat rendah lainnya memiliki fungsionalitas tanggal, waktu, dan zona waktu yang hampir lengkap, tetapi tidak berfungsi dengan baik dari perspektif kegunaan:

• Terlalu banyak modul: datetime, time, kalender, dateutil, pytz, dan lainnya
• Terlalu banyak jenis: tanggal, waktu, datetime, tzinfo, timedelta, relativedelta, dll.
• Konversi zona waktu dan stempel waktu bertele-tele dan tidak menyenangkan
• Kenaifan zona waktu adalah hal yang lumrah
• Kesenjangan dalam fungsionalitas: penguraian ISO 8601, rentang waktu, humanisasi

Fitur

• Penggantian drop-in untuk datetime yang diterapkan sepenuhnya
• Dukungan untuk Python 3.8+
• Sadar zona waktu dan UTC secara default
• Opsi pembuatan super sederhana untuk banyak skenario masukan umum
• metode shift dengan dukungan untuk offset relatif, termasuk minggu
• Format dan parsing string secara otomatis
• Dukungan luas untuk standar ISO 8601
• Konversi zona waktu
• Dukungan untuk objek dateutil , pytz , dan ZoneInfo tzinfo
• Menghasilkan rentang waktu, rentang, batas bawah dan langit-langit untuk kerangka waktu mulai dari mikrodetik hingga tahun
• Memanusiakan tanggal dan waktu dengan daftar lokal yang berkontribusi yang terus bertambah
• Dapat diperluas untuk tipe turunan Panah Anda sendiri
• Dukungan penuh untuk petunjuk tipe gaya PEP 484

Mulai Cepat

Instalasi

Untuk menginstal Arrow, gunakan pip atau pipenv:

$ pip install -U arrow

Contoh Penggunaan

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

Dokumentasi

Untuk dokumentasi lengkap, silakan kunjungi panah.readthedocs.io.

Berkontribusi

Kontribusi diterima baik untuk kode maupun pelokalan (menambah dan memperbarui lokal). Mulailah dengan mengenal perpustakaan Arrow dan fitur-fiturnya. Kemudian, mulailah berkontribusi:

1. Temukan masalah atau fitur yang perlu ditangani di pelacak masalah. Terbitan yang ditandai dengan label "terbitan pertama yang bagus" mungkin merupakan awal yang baik!
2. Garpu repositori ini di GitHub dan mulailah membuat perubahan di cabang.
3. Tambahkan beberapa pengujian untuk memastikan bahwa bug telah diperbaiki atau fitur berfungsi seperti yang diharapkan.
4. Jalankan seluruh test suite dan pemeriksaan linting dengan menjalankan salah satu perintah berikut: tox && tox -e lint,docs (jika Anda telah menginstal tox) ATAU make build39 && make test && make lint (jika Anda belum menginstal Python 3.9, ganti build39 dengan versi Python terbaru di sistem Anda).
5. Kirim permintaan tarik dan tunggu umpan balik?.

Jika Anda memiliki pertanyaan selama ini, jangan ragu untuk menanyakannya di sini.

Panah Dukungan

Open Collective adalah platform pendanaan online yang menyediakan alat untuk mengumpulkan uang dan membagikan keuangan Anda dengan transparansi penuh. Ini adalah platform pilihan bagi individu dan perusahaan untuk memberikan donasi satu kali atau berulang langsung ke proyek. Jika Anda tertarik untuk memberikan kontribusi finansial, silakan kunjungi kolektif Arrow.