Pustaka Kalender Jawa

Sejarah Penanggalan Jawa

Menurut sejarahnya Penanggalan Jawa merupakan hasil olah para Wali dan para leluhur Jawa dan kemudian diwariskan terutama melalui rumus perhitungan dengan cara hafalan dan hebatnya rumus perhitungan ini bersifat abadi dan sangat akurat sampai hampir 1000 tahun.

"Dengan terhafal dalam bentuk nyanyian, kalender Jawa akan terbawa kemana saja pergi, dan masih memiliki tingkat akurasi tinggi sampai 994 tahun lagi. Setelah itu baru ada koreksi +1 hari sebelum Ambal Kurup Alip Senen Kliwon, 1 Sura 2947 Jawa (26 Januari 2984 Masehi)" - REF.

Silahkan membaca lebih lanjut tentang Penanggalan Jawa di Website Kalender Jawa.

@kalenderjawa/pustaka

Pustaka Kalender Jawa ini merupakan pustaka khusus yang menyediakan perhitungan, informasi dan pengkonversian Penanggalan atau Kalender Jawa, dengan maksud dan tujuan supaya Penanggalan Jawa lebih mudah dikenal dan dipakai secara umum, khususnya buat para pengembang.

Pustaka Kalender Jawa ini ditulis memakai bahasa JavaScript (ECMAScript 2015 atau ES6) dan memakai ES Module.

Hasil Build

Ada 3 hasil build dan default adalah build untuk Node.js ataupun browser yang mendukung ES Module (ESM).

Browser yang tidak mendukung ESM

kalenderjawa.browser.min.js

Node.js yang tidak mendukung ESM (sebelum Node.js 12.17.0)

kalenderjawa.min.cjs

Node.js & browser yang mendukung ESM

kalenderjawa.min.js

Contoh penggunaan hasil build diatas ada pada direktori examples

Instalasi

Pustaka Kalender Jawa bisa dipakai dilingkungan Node maupun Browser.

Node

npm install --save @kalenderjawa/pustaka

Secara default anda akan memakai Pustaka yang mendukung ES Module, benar yaitu yang memakai import

import * as KalenderJawa from "@kalenderjawa/pustaka";

KalenderJawa.cariKurupTahunJawa(1881).then(/**...*/);

Untuk Node.js yang belum mendukung ES Module (Node.js sebelum v12.17.0) silahkan memakai berkas kalenderjawa.min.cjs pada direktori lib.

Browser

Jika anda memakai browser Pustaka ini bisa di ambil melalui CDN (Content Delivery Network) seperti di unpkg.com.

Kode berikut akan mengambil pustaka untuk browser yang tidak mendukung ES Module.

<script src="https://unpkg.com/@kalenderjawa/pustaka/lib/kalenderjawa.browser.min.js" />

dan kode berikut untuk browser yang mendukung ES Module

<script type="module">
  import * as KalenderJawa from "https://unpkg.com/@kalenderjawa/pustaka";

  console.log(KalenderJawa);
</script>

Testing

Untuk menjalankan testing. Silahkan pakai command berikut:

npm run test

Pengetestan memakai headless chrome dari Puppeteer.

API

Dokumentasi dan demo API ada di sini.

Berkontribusi

Untuk berkontribusi silahkan lihat dokumen CARA BERKONTRIBUSI.

Demo Kalender

Contoh aplikasi web yang memakai Pustaka ini adalah Sengkala. Proyek ini open-source jadi anda bisa melihat potensi dari pemakaian Pustaka ini.

Lisensi

MIT License

---

kalenderjawa.dev © (2019 - 2024)