nama-hari

Utilitas konversi dan analisis nama hari Indonesia, Jawa, Sunda, dan Inggris.

Instalasi

pip install nama-hari

Penggunaan Cepat

from nama_hari import ke_jawa, pasaran, hari_lengkap

ke_jawa("Senin")            # "Senen"
ke_jawa("Minggu")           # "Ahad"
pasaran("2026-10-21")       # "Wage" (contoh, verifikasi kalender Jawa)
hari_lengkap("2026-10-21")  # "Rabu Wage"

Penggunaan via Terminal (CLI)

Setelah instalasi, perintah nama-hari tersedia di terminal:

# Konversi nama hari
nama-hari --konversi Senin --ke jawa
# Output: Senin (jawa) -> Senen

# Info lengkap sebuah tanggal
nama-hari --tanggal 2026-10-21
# Output:
# Tanggal   : 2026-10-21
# Hari      : Rabu
# Pasaran   : Wage
# Lengkap   : Rabu Wage

# Selisih hari
nama-hari --selisih Senin Jumat
# Output: Selisih dari Senin ke Jumat: 4 hari

# Daftar semua hari
nama-hari --daftar jawa

# Hari ini & besok
nama-hari --hari-ini
nama-hari --besok

# Bantuan
nama-hari --help

Fitur

• Konversi nama hari: Indonesia, Jawa, Sunda, Inggris (dua arah)
• Normalisasi variasi ejaan: Jum'at, Jumaah, Senen, Rebo, Kemis, Ahad, dll.
• Hari pasaran Jawa: Legi, Pahing, Pon, Wage, Kliwon
• Utilitas tanggal: hari dari tanggal, selisih hari, hari ini, besok

Contoh Lengkap

from nama_hari import (
    ke_jawa, ke_sunda, ke_inggris, ke_indonesia,
    pasaran, hari_lengkap, hari_dari_tanggal, selisih,
)

# Konversi antar bahasa
ke_jawa("Rabu")        # "Rebo"
ke_sunda("Jumat")      # "Jumaah"
ke_inggris("Senin")    # "Monday"
ke_indonesia("Ahad")   # "Minggu"

# Hari dari tanggal
hari_dari_tanggal("2026-10-21")  # "Rabu"

# Hari pasaran Jawa
pasaran("2026-10-21")            # "Wage"
hari_lengkap("2026-10-21")       # "Rabu Wage"

# Selisih hari (0-6)
selisih("Senin", "Jumat")        # 4
selisih("Jumat", "Senin")        # 3

Daftar Bahasa yang Didukung

Catatan tentang Hari Pasaran

Hari pasaran Jawa (Legi, Pahing, Pon, Wage, Kliwon) berputar dengan siklus 5 hari, berjalan bersamaan dengan siklus 7 hari (minggu) sehingga membentuk siklus 35 hari (selapan). Perhitungan menggunakan anchor date yang wajib diverifikasi dengan kalender Jawa resmi sebelum digunakan untuk keperluan serius.

Development

git clone https://github.com/username/nama-hari.git
cd nama-hari
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
pytest -v

Build & Rilis

python -m build
twine upload --repository testpypi dist/*   # uji di TestPyPI dulu
twine upload dist/*                          # rilis ke PyPI

Lisensi

MIT