Tanggalan

Pustaka Rust lengkap untuk konversi Kalender Jawa. Mendukung Weton, Wuku, Neptu, Mongso (Solar), dan Waktu Tradisional (Wektu).

Instalasi

Tambahkan dependensi berikut ke Cargo.toml Anda:

[dependencies]
tanggalan = "1.1.2"
chrono = "0.4"

Penggunaan Dasar

Inti dari pustaka ini adalah struct JavaneseDate.

use tanggalan::JavaneseDate;
use chrono::NaiveDate;

fn main() {
    // 1. Membuat tanggal Masehi (17 Agustus 1945)
    // Jam 12:00 digunakan untuk menghindari ambiguitas pergantian hari
    let date = NaiveDate::from_ymd_opt(1945, 8, 17).unwrap()
        .and_hms_opt(12, 0, 0).unwrap();

    // 2. Konversi ke Tanggal Jawa
    let jd = JavaneseDate::new(date);

    // 3. Akses Properti
    println!("Dina: {}", jd.dina);       // Jemuah
    println!("Pasaran: {}", jd.pasaran); // Legi
    println!("Wuku: {}", jd.wuku);       // Manahil
    println!("Neptu: {}", jd.neptu);     // 11 (Jemuah 6 + Legi 5)
    
    // Output default (Display trait)
    println!("Lengkap: {}", jd); 
    // Output: Jemuah Legi, 9 Pasa 1876 Ja, Lingsir Wengi
}

Parsing String

Anda dapat membuat objek JavaneseDate dari string tanggal Jawa.

use tanggalan::JavaneseDate;

fn main() {
    let input = "28 Jumadilawal 1955";
    let format = "d M yyyy";

    match JavaneseDate::from_string(input, format) {
        Ok(jd) => {
            println!("Berhasil parse: {}", jd);
            println!("Weton: {} {}", jd.dina, jd.pasaran);
        },
        Err(e) => println!("Error: {}", e),
    }
}

Formatting

Gunakan method format_string untuk memformat output sesuai kebutuhan.

let pattern = "Dina: D, Pasaran: P, Mongso: MS";
println!("{}", jd.format_string(pattern));
// Output: Dina: Jemuah, Pasaran: Legi, Mongso: Karo

Token Format

Berikut adalah daftar token yang dapat digunakan dalam string format:

Fitur Lanjutan

Mencari Weton Berikutnya (weton_sabanjure)

Mencari tanggal terdekat di masa depan yang memiliki kombinasi Dina dan Pasaran tertentu.

let next_weton = jd.weton_sabanjure("Senen Legi");
match next_weton {
    Ok(date) => println!("Senen Legi berikutnya: {}", date),
    Err(e) => println!("Error: {}", e),
}

Cek Tahun Kabisat (is_kabisat)

if jd.is_kabisat() {
    println!("Tahun {} adalah tahun kabisat (355 hari)", jd.taun_jawa);
} else {
    println!("Tahun {} adalah tahun basit (354 hari)", jd.taun_jawa);
}

Referensi API

Struct JavaneseDate

Struct utama yang menyimpan informasi tanggal Jawa.

Static Methods

• from_string(input: &str, format: &str) -> Result<JavaneseDate, String>: Membuat instance dari string tanggal Jawa.
• new(date: NaiveDateTime) -> JavaneseDate: Membuat instance baru dari tanggal Masehi.

Properties (String)

Methods & Numeric Properties

Di Rust, sebagian besar "getter" diimplementasikan sebagai public field untuk efisiensi.

• day_jawa: u32 - Tanggal Jawa.
• dina_index: usize - Indeks hari (0=Minggu, 6=Setu).
• wulan_index: usize - Indeks bulan (0=Sura).
• taun_jawa: i32 - Tahun Jawa.
• pasaran_index: usize - Indeks pasaran (0=Legi).
• neptu: u8 - Total nilai neptu.
• wuku_index: usize - Indeks wuku (0=Sinta).
• native_date: NaiveDateTime - Objek tanggal asli dari chrono.
• is_kabisat(&self) -> bool: Mengecek apakah tahun Jawa saat ini adalah tahun kabisat (355 hari).
• weton_sabanjure(&self, weton_name: &str) -> Result<JavaneseDate, String>: Mencari tanggal terjadinya weton tertentu di masa depan.
• format_string(&self, pattern: &str) -> String: Memformat tanggal menjadi string menggunakan token.
• to_string(&self) -> String: (via Display trait) Representasi string default.

Dokumentasi Teknis

Ingin tahu bagaimana perhitungan matematis di balik kalender ini?

Baca Algoritma Perhitungan Kalender Jawa.

Untuk dokumentasi penggunaan versi lain, lihat Python, Node/Web, dan Go.

Referensi

• PRANOTO MONGSO (Penentuan Musim)
• Tanggalan Jawa
• Sejarah Kalender Jawa dan Fungsi Kegunaan
• Arane Wektu: Penyebutan Istilah Waktu dalam Bahasa Jawa
• Penanggalan Jawa atau Kalender Jawa

Lisensi

ISC