# API Tanggal

> Konversi, format, dan hitung selisih tanggal Masehi, Hijriah, dan Jawa.

Ubah tanggal antar kalender Masehi, Hijriah, dan penanggalan Jawa (pasaran), format ke bahasa Indonesia, hitung selisih hari, dan tambah atau kurangi durasi. Terhubung dengan kalender libur nasional sehingga bisa menghitung tanggal jatuh tempo pada hari kerja.

- Base URL: `https://api.apipedia.id/v1/tanggal`
- Autentikasi: `Authorization: Bearer apk_…` (token dari console.apipedia.id)
- Kategori: Data Publik
- Halaman: https://apipedia.id/docs/api-tanggal
- OpenAPI: https://console.apipedia.id/openapi/api-tanggal.yaml

Semua respons memakai amplop `{ "is_success", "message", "data" }` kecuali disebutkan lain. Kode error umum: lihat https://apipedia.id/docs#kode-status-error.

## Endpoint (2)

- `GET /hari-ini`: Tanggal hari ini dalam beberapa kalender
- `GET /selisih`: Hitung selisih dua tanggal

### Tanggal hari ini dalam beberapa kalender

`GET https://api.apipedia.id/v1/tanggal/hari-ini`

Tanggal hari ini menurut zona WIB: Masehi, nama hari, pasaran Jawa, Hijriah, dan status libur nasional.

Contoh request:

```bash
curl -X GET "https://api.apipedia.id/v1/tanggal/hari-ini" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx"
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "Tanggal hari ini berhasil diambil",
  "data": {
    "masehi": "2026-09-13",
    "hari": "Minggu",
    "pasaran": "Pon",
    "hijriah": "30 Rabiulawal 1448 H",
    "is_libur": false,
    "keterangan_libur": null
  }
}
```

### Hitung selisih dua tanggal

`GET https://api.apipedia.id/v1/tanggal/selisih`

Selisih hari, bulan penuh, dan hari kerja (Senin-Jumat dikurangi libur nasional) di antara dua tanggal. Kalau `sampai` lebih awal dari `mulai`, hasilnya negatif.

| Parameter | Lokasi | Tipe | Wajib | Keterangan |
|---|---|---|---|---|
| `mulai` | query | string | ya | Tanggal awal, format YYYY-MM-DD. |
| `sampai` | query | string | ya | Tanggal akhir, format YYYY-MM-DD. |

Contoh request:

```bash
curl -X GET "https://api.apipedia.id/v1/tanggal/selisih?mulai=2026-09-01&sampai=2026-12-25" \
  -H "Authorization: Bearer apk_xxxxxxxxxxxxxxxx"
```

Contoh respons (200):

```json
{
  "is_success": true,
  "message": "Selisih tanggal berhasil dihitung",
  "data": {
    "mulai": "2026-09-01",
    "sampai": "2026-12-25",
    "hari": 115,
    "bulan": 3,
    "hari_kerja": 82
  }
}
```
