@ghifari29/id-kit 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -21,6 +21,8 @@ import { parseNIK, isValidNIK } from "@ghifari29/id-kit/nik";
21
21
  import { mask, maskNIK, maskPhone, maskAccount } from "@ghifari29/id-kit/mask";
22
22
  import { parseNPWP, parseNITKU, isValidNPWP, isValidNITKU } from "@ghifari29/id-kit/npwp";
23
23
  import { getBank, listBank } from "@ghifari29/id-kit/bank";
24
+ import { cekLibur, daftarLibur, tahunTersedia } from "@ghifari29/id-kit/libur";
25
+ import { formatTanggal, formatWaktu, formatTanggalWaktu, keZonaWaktu, zonaWaktuProvinsi } from "@ghifari29/id-kit/waktu";
24
26
 
25
27
  terbilang(1250000);
26
28
  // "satu juta dua ratus lima puluh ribu rupiah"
@@ -63,6 +65,21 @@ parseNITKU("0012345678901000000000");
63
65
 
64
66
  getBank("014");
65
67
  // { kode: "014", nama: "Bank Central Asia (BCA)" }
68
+
69
+ cekLibur("2026-08-17");
70
+ // { status: "libur-nasional", nama: "Proklamasi Kemerdekaan" }
71
+
72
+ cekLibur("2099-01-01");
73
+ // { status: "data-tidak-tersedia", tahun: 2099 }
74
+
75
+ formatTanggal("2026-11-18", { denganHari: true });
76
+ // "Rabu, 18 November 2026"
77
+
78
+ formatTanggalWaktu("2026-11-18T13:35:00Z", { zona: "WITA" });
79
+ // "18 November 2026, 21:35 WITA"
80
+
81
+ zonaWaktuProvinsi("64");
82
+ // "WITA"
66
83
  ```
67
84
 
68
85
  ## Fitur
@@ -74,8 +91,8 @@ getBank("014");
74
91
  - [x] `detectOperator` (deteksi operator seluler asal)
75
92
  - [x] `parseNPWP`, `isValidNPWP`, `parseNITKU`, `isValidNITKU` (validasi format NPWP & NITKU)
76
93
  - [x] `getBank`, `listBank` (daftar kode bank 3 digit)
77
- - [ ] Validasi nomor rekening
78
- - [ ] Libur nasional dan cuti bersama
94
+ - [x] `cekLibur`, `daftarLibur`, `tahunTersedia` (libur nasional dan cuti bersama)
95
+ - [x] `formatTanggal`, `formatWaktu`, `formatTanggalWaktu`, `keZonaWaktu`, `zonaWaktuProvinsi` (format & zona waktu Indonesia)
79
96
  - [ ] Data wilayah
80
97
 
81
98
  ## Batasan
@@ -87,6 +104,8 @@ getBank("014");
87
104
  - Modul `mask` (`mask`, `maskNIK`, `maskPhone`, `maskAccount`) hanya untuk **TAMPILAN** UI, bukan enkripsi atau anonimisasi. Jangan menyimpan data asli di log hanya karena sudah ada fungsi masking. Hanya `mask()` yang menjamin panjang hasil (dalam Unicode code point) sama dengan panjang input.
88
105
  - `parseNPWP`, `isValidNPWP`, `parseNITKU`, dan `isValidNITKU` hanya memvalidasi format dan panjang (tanpa checksum), bukan bukti terdaftar di DJP. Klasifikasi `"nik"` hanya menunjukkan bentuk cocok dengan NIK, bukan bukti NPWP orang pribadi terdaftar (WNA bukan penduduk tidak memakai NIK); pola `"badan-awalan-0"` (`0 + 15 digit`) hanya berlaku untuk entitas terdaftar sebelum 14 Juli 2022.
89
106
  - Modul `bank` (`getBank`, `listBank`) diverifikasi pada `2026-11-18` dari sumber sekunder (jaringan switching dan situs bank) karena Bank Indonesia tidak menerbitkan satu tabel terbuka untuk semua kode 3 digit. Daftar bisa usang akibat perubahan nama atau merger—cocokkan dengan sumber resmi bank sebelum dipakai untuk transaksi. Tidak ada validasi panjang nomor rekening, dengan sengaja.
107
+ - Modul `libur` (`cekLibur`, `daftarLibur`, `tahunTersedia`) diverifikasi pada `2026-11-18` dari SKB 3 Menteri (Kemenag, Kemnaker, KemenPAN-RB). SKB dapat direvisi di tengah tahun (contoh: pada 2025, satu hari cuti bersama ditambahkan pada Agustus), sehingga data bisa kedaluwarsa dan library membutuhkan rilis baru tiap tahun untuk menambah data tahun berikutnya. Tahun tanpa data menghasilkan `"data-tidak-tersedia"`, bukan `"bukan-libur"`. Ini bukan nasihat hukum mengenai hak cuti atau upah lembur, dan hari libur lokal atau daerah tidak termasuk.
108
+ - Modul `waktu` menolak string ISO tanpa zona waktu eksplisit agar tidak bergantung pada zona waktu mesin lokal (`YYYY-MM-DD` hanya diterima pada `formatTanggal`). Konversi memakai offset tetap (`WIB` `+07:00`, `WITA` `+08:00`, `WIT` `+09:00`) tanpa DST. `zonaWaktuProvinsi` menggunakan 38 kode provinsi Kemendagri (`11`–`96`) agar konsisten dengan modul `nik`, bukan kode wilayah kerja statistik BPS yang berbeda di wilayah Papua.
90
109
 
91
110
  ## Berkontribusi
92
111
 
@@ -0,0 +1,151 @@
1
+ // src/libur/data.ts
2
+ var DATA_LIBUR = {
3
+ 2025: [
4
+ { tanggal: "2025-01-01", nama: "Tahun Baru 2025 Masehi", jenis: "libur-nasional" },
5
+ { tanggal: "2025-01-27", nama: "Isra Mikraj Nabi Muhammad SAW", jenis: "libur-nasional" },
6
+ { tanggal: "2025-01-28", nama: "Tahun Baru Imlek 2576 Kongzili", jenis: "cuti-bersama" },
7
+ { tanggal: "2025-01-29", nama: "Tahun Baru Imlek 2576 Kongzili", jenis: "libur-nasional" },
8
+ { tanggal: "2025-03-28", nama: "Hari Suci Nyepi (Tahun Baru Saka 1947)", jenis: "cuti-bersama" },
9
+ { tanggal: "2025-03-29", nama: "Hari Suci Nyepi (Tahun Baru Saka 1947)", jenis: "libur-nasional" },
10
+ { tanggal: "2025-03-31", nama: "Hari Raya Idulfitri 1446 Hijriah", jenis: "libur-nasional" },
11
+ { tanggal: "2025-04-01", nama: "Hari Raya Idulfitri 1446 Hijriah", jenis: "libur-nasional" },
12
+ { tanggal: "2025-04-02", nama: "Hari Raya Idulfitri 1446 Hijriah", jenis: "cuti-bersama" },
13
+ { tanggal: "2025-04-03", nama: "Hari Raya Idulfitri 1446 Hijriah", jenis: "cuti-bersama" },
14
+ { tanggal: "2025-04-04", nama: "Hari Raya Idulfitri 1446 Hijriah", jenis: "cuti-bersama" },
15
+ { tanggal: "2025-04-07", nama: "Hari Raya Idulfitri 1446 Hijriah", jenis: "cuti-bersama" },
16
+ { tanggal: "2025-04-18", nama: "Wafat Yesus Kristus", jenis: "libur-nasional" },
17
+ { tanggal: "2025-04-20", nama: "Kebangkitan Yesus Kristus (Paskah)", jenis: "libur-nasional" },
18
+ { tanggal: "2025-05-01", nama: "Hari Buruh Internasional", jenis: "libur-nasional" },
19
+ { tanggal: "2025-05-12", nama: "Hari Raya Waisak 2569 BE", jenis: "libur-nasional" },
20
+ { tanggal: "2025-05-13", nama: "Hari Raya Waisak 2569 BE", jenis: "cuti-bersama" },
21
+ { tanggal: "2025-05-29", nama: "Kenaikan Yesus Kristus", jenis: "libur-nasional" },
22
+ { tanggal: "2025-05-30", nama: "Kenaikan Yesus Kristus", jenis: "cuti-bersama" },
23
+ { tanggal: "2025-06-01", nama: "Hari Lahir Pancasila", jenis: "libur-nasional" },
24
+ { tanggal: "2025-06-06", nama: "Hari Raya Iduladha 1446 Hijriah", jenis: "libur-nasional" },
25
+ { tanggal: "2025-06-09", nama: "Hari Raya Iduladha 1446 Hijriah", jenis: "cuti-bersama" },
26
+ { tanggal: "2025-06-27", nama: "1 Muharam Tahun Baru Islam 1447 Hijriah", jenis: "libur-nasional" },
27
+ { tanggal: "2025-08-17", nama: "Proklamasi Kemerdekaan", jenis: "libur-nasional" },
28
+ { tanggal: "2025-08-18", nama: "HUT ke-80 Kemerdekaan Republik Indonesia", jenis: "cuti-bersama" },
29
+ { tanggal: "2025-09-05", nama: "Maulid Nabi Muhammad SAW", jenis: "libur-nasional" },
30
+ { tanggal: "2025-12-25", nama: "Kelahiran Yesus Kristus", jenis: "libur-nasional" },
31
+ { tanggal: "2025-12-26", nama: "Kelahiran Yesus Kristus", jenis: "cuti-bersama" }
32
+ ],
33
+ 2026: [
34
+ { tanggal: "2026-01-01", nama: "Tahun Baru 2026 Masehi", jenis: "libur-nasional" },
35
+ { tanggal: "2026-01-16", nama: "Isra Mikraj Nabi Muhammad SAW", jenis: "libur-nasional" },
36
+ { tanggal: "2026-02-16", nama: "Tahun Baru Imlek 2577 Kongzili", jenis: "cuti-bersama" },
37
+ { tanggal: "2026-02-17", nama: "Tahun Baru Imlek 2577 Kongzili", jenis: "libur-nasional" },
38
+ { tanggal: "2026-03-18", nama: "Hari Suci Nyepi (Tahun Baru Saka 1948)", jenis: "cuti-bersama" },
39
+ { tanggal: "2026-03-19", nama: "Hari Suci Nyepi (Tahun Baru Saka 1948)", jenis: "libur-nasional" },
40
+ { tanggal: "2026-03-20", nama: "Hari Raya Idulfitri 1447 Hijriah", jenis: "cuti-bersama" },
41
+ { tanggal: "2026-03-21", nama: "Hari Raya Idulfitri 1447 Hijriah", jenis: "libur-nasional" },
42
+ { tanggal: "2026-03-22", nama: "Hari Raya Idulfitri 1447 Hijriah", jenis: "libur-nasional" },
43
+ { tanggal: "2026-03-23", nama: "Hari Raya Idulfitri 1447 Hijriah", jenis: "cuti-bersama" },
44
+ { tanggal: "2026-03-24", nama: "Hari Raya Idulfitri 1447 Hijriah", jenis: "cuti-bersama" },
45
+ { tanggal: "2026-04-03", nama: "Wafat Yesus Kristus", jenis: "libur-nasional" },
46
+ { tanggal: "2026-04-05", nama: "Kebangkitan Yesus Kristus (Paskah)", jenis: "libur-nasional" },
47
+ { tanggal: "2026-05-01", nama: "Hari Buruh Internasional", jenis: "libur-nasional" },
48
+ { tanggal: "2026-05-14", nama: "Kenaikan Yesus Kristus", jenis: "libur-nasional" },
49
+ { tanggal: "2026-05-15", nama: "Kenaikan Yesus Kristus", jenis: "cuti-bersama" },
50
+ { tanggal: "2026-05-27", nama: "Hari Raya Iduladha 1447 Hijriah", jenis: "libur-nasional" },
51
+ { tanggal: "2026-05-28", nama: "Hari Raya Iduladha 1447 Hijriah", jenis: "cuti-bersama" },
52
+ { tanggal: "2026-05-31", nama: "Hari Raya Waisak 2570 BE", jenis: "libur-nasional" },
53
+ { tanggal: "2026-06-01", nama: "Hari Lahir Pancasila", jenis: "libur-nasional" },
54
+ { tanggal: "2026-06-16", nama: "1 Muharam Tahun Baru Islam 1448 Hijriah", jenis: "libur-nasional" },
55
+ { tanggal: "2026-08-17", nama: "Proklamasi Kemerdekaan", jenis: "libur-nasional" },
56
+ { tanggal: "2026-08-25", nama: "Maulid Nabi Muhammad SAW", jenis: "libur-nasional" },
57
+ { tanggal: "2026-12-24", nama: "Kelahiran Yesus Kristus", jenis: "cuti-bersama" },
58
+ { tanggal: "2026-12-25", nama: "Kelahiran Yesus Kristus", jenis: "libur-nasional" }
59
+ ],
60
+ 2027: [
61
+ { tanggal: "2027-01-01", nama: "Tahun Baru 2027 Masehi", jenis: "libur-nasional" },
62
+ { tanggal: "2027-01-05", nama: "Isra Mikraj Nabi Muhammad SAW 1448 Hijriah", jenis: "libur-nasional" },
63
+ { tanggal: "2027-02-05", nama: "Tahun Baru Imlek 2578 Kongzili", jenis: "cuti-bersama" },
64
+ { tanggal: "2027-02-06", nama: "Tahun Baru Imlek 2578 Kongzili", jenis: "libur-nasional" },
65
+ { tanggal: "2027-03-08", nama: "Hari Suci Nyepi (Tahun Baru Saka 1949)", jenis: "libur-nasional" },
66
+ { tanggal: "2027-03-09", nama: "Hari Raya Idulfitri 1448 Hijriah", jenis: "cuti-bersama" },
67
+ { tanggal: "2027-03-10", nama: "Hari Raya Idulfitri 1448 Hijriah", jenis: "libur-nasional" },
68
+ { tanggal: "2027-03-11", nama: "Hari Raya Idulfitri 1448 Hijriah", jenis: "libur-nasional" },
69
+ { tanggal: "2027-03-12", nama: "Hari Raya Idulfitri 1448 Hijriah", jenis: "cuti-bersama" },
70
+ { tanggal: "2027-03-15", nama: "Hari Raya Idulfitri 1448 Hijriah", jenis: "cuti-bersama" },
71
+ { tanggal: "2027-03-25", nama: "Wafat Yesus Kristus", jenis: "cuti-bersama" },
72
+ { tanggal: "2027-03-26", nama: "Wafat Yesus Kristus", jenis: "libur-nasional" },
73
+ { tanggal: "2027-03-28", nama: "Kebangkitan Yesus Kristus (Paskah)", jenis: "libur-nasional" },
74
+ { tanggal: "2027-05-01", nama: "Hari Buruh Internasional", jenis: "libur-nasional" },
75
+ { tanggal: "2027-05-06", nama: "Kenaikan Yesus Kristus", jenis: "libur-nasional" },
76
+ { tanggal: "2027-05-17", nama: "Hari Raya Iduladha 1448 Hijriah", jenis: "libur-nasional" },
77
+ { tanggal: "2027-05-18", nama: "Hari Raya Iduladha 1448 Hijriah", jenis: "cuti-bersama" },
78
+ { tanggal: "2027-05-19", nama: "Hari Raya Waisak 2571 BE", jenis: "cuti-bersama" },
79
+ { tanggal: "2027-05-20", nama: "Hari Raya Waisak 2571 BE", jenis: "libur-nasional" },
80
+ { tanggal: "2027-06-01", nama: "Hari Lahir Pancasila", jenis: "libur-nasional" },
81
+ { tanggal: "2027-06-06", nama: "1 Muharam Tahun Baru Islam 1449 Hijriah", jenis: "libur-nasional" },
82
+ { tanggal: "2027-08-15", nama: "Maulid Nabi Muhammad SAW", jenis: "libur-nasional" },
83
+ { tanggal: "2027-08-17", nama: "Proklamasi Kemerdekaan", jenis: "libur-nasional" },
84
+ { tanggal: "2027-12-24", nama: "Kelahiran Yesus Kristus", jenis: "cuti-bersama" },
85
+ { tanggal: "2027-12-25", nama: "Kelahiran Yesus Kristus", jenis: "libur-nasional" },
86
+ { tanggal: "2027-12-26", nama: "Isra Mikraj Nabi Muhammad SAW 1449 Hijriah", jenis: "libur-nasional" }
87
+ ]
88
+ };
89
+
90
+ // src/libur/libur.ts
91
+ var LIBUR_INDEX = new Map(
92
+ Object.entries(DATA_LIBUR).map(([yearKey, items]) => [
93
+ Number(yearKey),
94
+ new Map(items.map((item) => [item.tanggal, item]))
95
+ ])
96
+ );
97
+ var AVAILABLE_YEARS = [...LIBUR_INDEX.keys()].sort(
98
+ (a, b) => a - b
99
+ );
100
+ function parseStrictISODate(tanggal) {
101
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(tanggal)) {
102
+ throw new RangeError("Format tanggal harus YYYY-MM-DD yang valid");
103
+ }
104
+ const year = Number(tanggal.slice(0, 4));
105
+ const month = Number(tanggal.slice(5, 7));
106
+ const day = Number(tanggal.slice(8, 10));
107
+ if (year < 1e3 || year > 9999 || month < 1 || month > 12 || day < 1 || day > 31) {
108
+ throw new RangeError("Format tanggal harus YYYY-MM-DD yang valid");
109
+ }
110
+ const date = new Date(Date.UTC(year, month - 1, day));
111
+ if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) {
112
+ throw new RangeError("Format tanggal harus YYYY-MM-DD yang valid");
113
+ }
114
+ return year;
115
+ }
116
+ function cekLibur(tanggal) {
117
+ if (typeof tanggal !== "string") {
118
+ throw new TypeError("Tanggal harus berupa string");
119
+ }
120
+ const tahun = parseStrictISODate(tanggal);
121
+ const yearMap = LIBUR_INDEX.get(tahun);
122
+ if (!yearMap) {
123
+ return { status: "data-tidak-tersedia", tahun };
124
+ }
125
+ const found = yearMap.get(tanggal);
126
+ if (!found) {
127
+ return { status: "bukan-libur" };
128
+ }
129
+ return { status: found.jenis, nama: found.nama };
130
+ }
131
+ function daftarLibur(tahun) {
132
+ if (typeof tahun !== "number") {
133
+ throw new TypeError("Tahun harus berupa number");
134
+ }
135
+ if (!Number.isInteger(tahun)) {
136
+ throw new RangeError("Tahun harus berupa bilangan bulat");
137
+ }
138
+ if (!Object.prototype.hasOwnProperty.call(DATA_LIBUR, tahun)) {
139
+ return null;
140
+ }
141
+ return DATA_LIBUR[tahun].map((item) => ({ ...item }));
142
+ }
143
+ function tahunTersedia() {
144
+ return [...AVAILABLE_YEARS];
145
+ }
146
+
147
+ export {
148
+ cekLibur,
149
+ daftarLibur,
150
+ tahunTersedia
151
+ };
@@ -0,0 +1,282 @@
1
+ // src/waktu/waktu.ts
2
+ var NAMA_HARI = [
3
+ "Minggu",
4
+ "Senin",
5
+ "Selasa",
6
+ "Rabu",
7
+ "Kamis",
8
+ "Jumat",
9
+ "Sabtu"
10
+ ];
11
+ var NAMA_HARI_SINGKAT = [
12
+ "Min",
13
+ "Sen",
14
+ "Sel",
15
+ "Rab",
16
+ "Kam",
17
+ "Jum",
18
+ "Sab"
19
+ ];
20
+ var NAMA_BULAN = [
21
+ "Januari",
22
+ "Februari",
23
+ "Maret",
24
+ "April",
25
+ "Mei",
26
+ "Juni",
27
+ "Juli",
28
+ "Agustus",
29
+ "September",
30
+ "Oktober",
31
+ "November",
32
+ "Desember"
33
+ ];
34
+ var NAMA_BULAN_SINGKAT = [
35
+ "Jan",
36
+ "Feb",
37
+ "Mar",
38
+ "Apr",
39
+ "Mei",
40
+ "Jun",
41
+ "Jul",
42
+ "Agu",
43
+ "Sep",
44
+ "Okt",
45
+ "Nov",
46
+ "Des"
47
+ ];
48
+ var ZONA_OFFSET_HOURS = {
49
+ WIB: 7,
50
+ WITA: 8,
51
+ WIT: 9
52
+ };
53
+ var ZONA_OFFSET_STRING = {
54
+ WIB: "+07:00",
55
+ WITA: "+08:00",
56
+ WIT: "+09:00"
57
+ };
58
+ var PROVINSI_ZONA = {
59
+ // WIB (Sumatra, Jawa, Kalimantan Barat, Kalimantan Tengah)
60
+ "11": "WIB",
61
+ "12": "WIB",
62
+ "13": "WIB",
63
+ "14": "WIB",
64
+ "15": "WIB",
65
+ "16": "WIB",
66
+ "17": "WIB",
67
+ "18": "WIB",
68
+ "19": "WIB",
69
+ "21": "WIB",
70
+ "31": "WIB",
71
+ "32": "WIB",
72
+ "33": "WIB",
73
+ "34": "WIB",
74
+ "35": "WIB",
75
+ "36": "WIB",
76
+ "61": "WIB",
77
+ "62": "WIB",
78
+ // WITA (Bali, Nusa Tenggara, Kalimantan Selatan/Timur/Utara, Sulawesi)
79
+ "51": "WITA",
80
+ "52": "WITA",
81
+ "53": "WITA",
82
+ "63": "WITA",
83
+ "64": "WITA",
84
+ "65": "WITA",
85
+ "71": "WITA",
86
+ "72": "WITA",
87
+ "73": "WITA",
88
+ "74": "WITA",
89
+ "75": "WITA",
90
+ "76": "WITA",
91
+ // WIT (Maluku, Maluku Utara, Papua & DOB Papua)
92
+ "81": "WIT",
93
+ "82": "WIT",
94
+ "91": "WIT",
95
+ "92": "WIT",
96
+ "93": "WIT",
97
+ "94": "WIT",
98
+ "95": "WIT",
99
+ "96": "WIT"
100
+ };
101
+ var DATE_ONLY_REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;
102
+ var ISO_OFFSET_REGEX = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?(?:[Zz]|([+-])(\d{2}):?(\d{2}))$/;
103
+ function pad2(n) {
104
+ return String(n).padStart(2, "0");
105
+ }
106
+ function pad4(n) {
107
+ return String(n).padStart(4, "0");
108
+ }
109
+ function validateZona(zona) {
110
+ if (zona === void 0) {
111
+ return "WIB";
112
+ }
113
+ if (zona !== "WIB" && zona !== "WITA" && zona !== "WIT") {
114
+ throw new RangeError("Zona waktu harus WIB, WITA, atau WIT");
115
+ }
116
+ return zona;
117
+ }
118
+ function assertOptionsObject(options) {
119
+ if (options !== void 0 && (typeof options !== "object" || options === null || Array.isArray(options))) {
120
+ throw new TypeError("Opsi harus berupa objek");
121
+ }
122
+ }
123
+ function assertOptionalBoolean(value, fallback) {
124
+ if (value === void 0) {
125
+ return fallback;
126
+ }
127
+ if (typeof value !== "boolean") {
128
+ throw new TypeError("Opsi boolean harus berupa boolean");
129
+ }
130
+ return value;
131
+ }
132
+ function isValidUTCDateParts(year, month, day) {
133
+ if (year < 1e3 || year > 9999 || month < 1 || month > 12 || day < 1 || day > 31) {
134
+ return false;
135
+ }
136
+ const dt = new Date(Date.UTC(year, month - 1, day));
137
+ return dt.getUTCFullYear() === year && dt.getUTCMonth() === month - 1 && dt.getUTCDate() === day;
138
+ }
139
+ function parseDateOnlyParts(input) {
140
+ const match = DATE_ONLY_REGEX.exec(input);
141
+ if (!match) {
142
+ return null;
143
+ }
144
+ const tahun = Number(match[1]);
145
+ const bulan = Number(match[2]);
146
+ const tanggal = Number(match[3]);
147
+ if (!isValidUTCDateParts(tahun, bulan, tanggal)) {
148
+ throw new RangeError("Format tanggal atau waktu tidak valid");
149
+ }
150
+ const hari = new Date(Date.UTC(tahun, bulan - 1, tanggal)).getUTCDay();
151
+ return { tahun, bulan, tanggal, hari };
152
+ }
153
+ function parseInstantToUTCMs(input) {
154
+ if (input instanceof Date) {
155
+ const ms2 = input.getTime();
156
+ if (!Number.isFinite(ms2)) {
157
+ throw new RangeError("Format tanggal atau waktu tidak valid");
158
+ }
159
+ return ms2;
160
+ }
161
+ if (typeof input !== "string") {
162
+ throw new TypeError("Input harus berupa Date atau string ISO yang valid");
163
+ }
164
+ const match = ISO_OFFSET_REGEX.exec(input);
165
+ if (!match) {
166
+ throw new RangeError("Format tanggal atau waktu tidak valid");
167
+ }
168
+ const year = Number(match[1]);
169
+ const month = Number(match[2]);
170
+ const day = Number(match[3]);
171
+ const hour = Number(match[4]);
172
+ const minute = Number(match[5]);
173
+ const second = match[6] !== void 0 ? Number(match[6]) : 0;
174
+ const ms = match[7] !== void 0 ? Number(match[7].slice(0, 3).padEnd(3, "0")) : 0;
175
+ if (!isValidUTCDateParts(year, month, day) || hour > 23 || minute > 59 || second > 59) {
176
+ throw new RangeError("Format tanggal atau waktu tidak valid");
177
+ }
178
+ let offsetMinutes = 0;
179
+ if (match[8] !== void 0) {
180
+ const sign = match[8] === "+" ? 1 : -1;
181
+ const offHours = Number(match[9]);
182
+ const offMins = Number(match[10]);
183
+ if (offHours > 23 || offMins > 59) {
184
+ throw new RangeError("Format tanggal atau waktu tidak valid");
185
+ }
186
+ offsetMinutes = sign * (offHours * 60 + offMins);
187
+ }
188
+ return Date.UTC(year, month - 1, day, hour, minute, second, ms) - offsetMinutes * 6e4;
189
+ }
190
+ function formatDateParts(parts, denganHari, singkat) {
191
+ const bulanNama = singkat ? NAMA_BULAN_SINGKAT[parts.bulan - 1] : NAMA_BULAN[parts.bulan - 1];
192
+ const tanggalText = `${parts.tanggal} ${bulanNama} ${parts.tahun}`;
193
+ if (!denganHari) {
194
+ return tanggalText;
195
+ }
196
+ const hariNama = singkat ? NAMA_HARI_SINGKAT[parts.hari] : NAMA_HARI[parts.hari];
197
+ return `${hariNama}, ${tanggalText}`;
198
+ }
199
+ function formatTimeParts(parts, denganDetik, tampilkanZona) {
200
+ const base = denganDetik ? `${pad2(parts.jam)}:${pad2(parts.menit)}:${pad2(parts.detik)}` : `${pad2(parts.jam)}:${pad2(parts.menit)}`;
201
+ return tampilkanZona ? `${base} ${parts.zona}` : base;
202
+ }
203
+ function keZonaWaktu(input, zona = "WIB") {
204
+ const targetZona = validateZona(zona);
205
+ const utcMs = parseInstantToUTCMs(input);
206
+ const offsetHours = ZONA_OFFSET_HOURS[targetZona];
207
+ const shifted = new Date(utcMs + offsetHours * 36e5);
208
+ const tahun = shifted.getUTCFullYear();
209
+ const bulan = shifted.getUTCMonth() + 1;
210
+ const tanggal = shifted.getUTCDate();
211
+ const hari = shifted.getUTCDay();
212
+ const jam = shifted.getUTCHours();
213
+ const menit = shifted.getUTCMinutes();
214
+ const detik = shifted.getUTCSeconds();
215
+ const offset = ZONA_OFFSET_STRING[targetZona];
216
+ return {
217
+ tahun,
218
+ bulan,
219
+ tanggal,
220
+ hari,
221
+ jam,
222
+ menit,
223
+ detik,
224
+ zona: targetZona,
225
+ offset,
226
+ iso: `${pad4(tahun)}-${pad2(bulan)}-${pad2(tanggal)}T${pad2(jam)}:${pad2(menit)}:${pad2(detik)}${offset}`
227
+ };
228
+ }
229
+ function formatTanggal(input, options) {
230
+ assertOptionsObject(options);
231
+ const zona = validateZona(options?.zona);
232
+ const denganHari = assertOptionalBoolean(options?.denganHari, false);
233
+ const singkat = assertOptionalBoolean(options?.singkat, false);
234
+ if (typeof input === "string") {
235
+ const dateOnly = parseDateOnlyParts(input);
236
+ if (dateOnly) {
237
+ return formatDateParts(dateOnly, denganHari, singkat);
238
+ }
239
+ } else if (!(input instanceof Date)) {
240
+ throw new TypeError("Input harus berupa Date atau string tanggal yang valid");
241
+ }
242
+ const parts = keZonaWaktu(input, zona);
243
+ return formatDateParts(parts, denganHari, singkat);
244
+ }
245
+ function formatWaktu(input, options) {
246
+ assertOptionsObject(options);
247
+ const zona = validateZona(options?.zona);
248
+ const denganDetik = assertOptionalBoolean(options?.denganDetik, false);
249
+ const tampilkanZona = assertOptionalBoolean(options?.tampilkanZona, true);
250
+ const parts = keZonaWaktu(input, zona);
251
+ return formatTimeParts(parts, denganDetik, tampilkanZona);
252
+ }
253
+ function formatTanggalWaktu(input, options) {
254
+ assertOptionsObject(options);
255
+ const zona = validateZona(options?.zona);
256
+ const denganHari = assertOptionalBoolean(options?.denganHari, false);
257
+ const singkat = assertOptionalBoolean(options?.singkat, false);
258
+ const denganDetik = assertOptionalBoolean(options?.denganDetik, false);
259
+ const tampilkanZona = assertOptionalBoolean(options?.tampilkanZona, true);
260
+ const parts = keZonaWaktu(input, zona);
261
+ const tanggalText = formatDateParts(parts, denganHari, singkat);
262
+ const waktuText = formatTimeParts(parts, denganDetik, tampilkanZona);
263
+ return `${tanggalText}, ${waktuText}`;
264
+ }
265
+ function zonaWaktuProvinsi(kodeProvinsi) {
266
+ if (typeof kodeProvinsi !== "string") {
267
+ throw new TypeError("Kode provinsi harus berupa string");
268
+ }
269
+ const trimmed = kodeProvinsi.trim();
270
+ if (!/^\d{2}$/.test(trimmed)) {
271
+ return null;
272
+ }
273
+ return Object.prototype.hasOwnProperty.call(PROVINSI_ZONA, trimmed) ? PROVINSI_ZONA[trimmed] : null;
274
+ }
275
+
276
+ export {
277
+ keZonaWaktu,
278
+ formatTanggal,
279
+ formatWaktu,
280
+ formatTanggalWaktu,
281
+ zonaWaktuProvinsi
282
+ };