@ghifari29/id-kit 0.6.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
@@ -22,6 +22,7 @@ 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
24
  import { cekLibur, daftarLibur, tahunTersedia } from "@ghifari29/id-kit/libur";
25
+ import { formatTanggal, formatWaktu, formatTanggalWaktu, keZonaWaktu, zonaWaktuProvinsi } from "@ghifari29/id-kit/waktu";
25
26
 
26
27
  terbilang(1250000);
27
28
  // "satu juta dua ratus lima puluh ribu rupiah"
@@ -70,6 +71,15 @@ cekLibur("2026-08-17");
70
71
 
71
72
  cekLibur("2099-01-01");
72
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"
73
83
  ```
74
84
 
75
85
  ## Fitur
@@ -82,7 +92,7 @@ cekLibur("2099-01-01");
82
92
  - [x] `parseNPWP`, `isValidNPWP`, `parseNITKU`, `isValidNITKU` (validasi format NPWP & NITKU)
83
93
  - [x] `getBank`, `listBank` (daftar kode bank 3 digit)
84
94
  - [x] `cekLibur`, `daftarLibur`, `tahunTersedia` (libur nasional dan cuti bersama)
85
- - [ ] Validasi nomor rekening
95
+ - [x] `formatTanggal`, `formatWaktu`, `formatTanggalWaktu`, `keZonaWaktu`, `zonaWaktuProvinsi` (format & zona waktu Indonesia)
86
96
  - [ ] Data wilayah
87
97
 
88
98
  ## Batasan
@@ -95,6 +105,7 @@ cekLibur("2099-01-01");
95
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.
96
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.
97
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.
98
109
 
99
110
  ## Berkontribusi
100
111
 
@@ -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
+ };
package/dist/index.cjs CHANGED
@@ -23,11 +23,15 @@ __export(src_exports, {
23
23
  cekLibur: () => cekLibur,
24
24
  daftarLibur: () => daftarLibur,
25
25
  detectOperator: () => detectOperator,
26
+ formatTanggal: () => formatTanggal,
27
+ formatTanggalWaktu: () => formatTanggalWaktu,
28
+ formatWaktu: () => formatWaktu,
26
29
  getBank: () => getBank,
27
30
  isValidNIK: () => isValidNIK,
28
31
  isValidNITKU: () => isValidNITKU,
29
32
  isValidNPWP: () => isValidNPWP,
30
33
  isValidPhone: () => isValidPhone,
34
+ keZonaWaktu: () => keZonaWaktu,
31
35
  listBank: () => listBank,
32
36
  mask: () => mask,
33
37
  maskAccount: () => maskAccount,
@@ -39,7 +43,8 @@ __export(src_exports, {
39
43
  parseNPWP: () => parseNPWP,
40
44
  rupiah: () => rupiah,
41
45
  tahunTersedia: () => tahunTersedia,
42
- terbilang: () => terbilang
46
+ terbilang: () => terbilang,
47
+ zonaWaktuProvinsi: () => zonaWaktuProvinsi
43
48
  });
44
49
  module.exports = __toCommonJS(src_exports);
45
50
 
@@ -606,16 +611,295 @@ function daftarLibur(tahun) {
606
611
  function tahunTersedia() {
607
612
  return [...AVAILABLE_YEARS];
608
613
  }
614
+
615
+ // src/waktu/waktu.ts
616
+ var NAMA_HARI = [
617
+ "Minggu",
618
+ "Senin",
619
+ "Selasa",
620
+ "Rabu",
621
+ "Kamis",
622
+ "Jumat",
623
+ "Sabtu"
624
+ ];
625
+ var NAMA_HARI_SINGKAT = [
626
+ "Min",
627
+ "Sen",
628
+ "Sel",
629
+ "Rab",
630
+ "Kam",
631
+ "Jum",
632
+ "Sab"
633
+ ];
634
+ var NAMA_BULAN = [
635
+ "Januari",
636
+ "Februari",
637
+ "Maret",
638
+ "April",
639
+ "Mei",
640
+ "Juni",
641
+ "Juli",
642
+ "Agustus",
643
+ "September",
644
+ "Oktober",
645
+ "November",
646
+ "Desember"
647
+ ];
648
+ var NAMA_BULAN_SINGKAT = [
649
+ "Jan",
650
+ "Feb",
651
+ "Mar",
652
+ "Apr",
653
+ "Mei",
654
+ "Jun",
655
+ "Jul",
656
+ "Agu",
657
+ "Sep",
658
+ "Okt",
659
+ "Nov",
660
+ "Des"
661
+ ];
662
+ var ZONA_OFFSET_HOURS = {
663
+ WIB: 7,
664
+ WITA: 8,
665
+ WIT: 9
666
+ };
667
+ var ZONA_OFFSET_STRING = {
668
+ WIB: "+07:00",
669
+ WITA: "+08:00",
670
+ WIT: "+09:00"
671
+ };
672
+ var PROVINSI_ZONA = {
673
+ // WIB (Sumatra, Jawa, Kalimantan Barat, Kalimantan Tengah)
674
+ "11": "WIB",
675
+ "12": "WIB",
676
+ "13": "WIB",
677
+ "14": "WIB",
678
+ "15": "WIB",
679
+ "16": "WIB",
680
+ "17": "WIB",
681
+ "18": "WIB",
682
+ "19": "WIB",
683
+ "21": "WIB",
684
+ "31": "WIB",
685
+ "32": "WIB",
686
+ "33": "WIB",
687
+ "34": "WIB",
688
+ "35": "WIB",
689
+ "36": "WIB",
690
+ "61": "WIB",
691
+ "62": "WIB",
692
+ // WITA (Bali, Nusa Tenggara, Kalimantan Selatan/Timur/Utara, Sulawesi)
693
+ "51": "WITA",
694
+ "52": "WITA",
695
+ "53": "WITA",
696
+ "63": "WITA",
697
+ "64": "WITA",
698
+ "65": "WITA",
699
+ "71": "WITA",
700
+ "72": "WITA",
701
+ "73": "WITA",
702
+ "74": "WITA",
703
+ "75": "WITA",
704
+ "76": "WITA",
705
+ // WIT (Maluku, Maluku Utara, Papua & DOB Papua)
706
+ "81": "WIT",
707
+ "82": "WIT",
708
+ "91": "WIT",
709
+ "92": "WIT",
710
+ "93": "WIT",
711
+ "94": "WIT",
712
+ "95": "WIT",
713
+ "96": "WIT"
714
+ };
715
+ var DATE_ONLY_REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;
716
+ var ISO_OFFSET_REGEX = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?(?:[Zz]|([+-])(\d{2}):?(\d{2}))$/;
717
+ function pad22(n) {
718
+ return String(n).padStart(2, "0");
719
+ }
720
+ function pad4(n) {
721
+ return String(n).padStart(4, "0");
722
+ }
723
+ function validateZona(zona) {
724
+ if (zona === void 0) {
725
+ return "WIB";
726
+ }
727
+ if (zona !== "WIB" && zona !== "WITA" && zona !== "WIT") {
728
+ throw new RangeError("Zona waktu harus WIB, WITA, atau WIT");
729
+ }
730
+ return zona;
731
+ }
732
+ function assertOptionsObject(options) {
733
+ if (options !== void 0 && (typeof options !== "object" || options === null || Array.isArray(options))) {
734
+ throw new TypeError("Opsi harus berupa objek");
735
+ }
736
+ }
737
+ function assertOptionalBoolean(value, fallback) {
738
+ if (value === void 0) {
739
+ return fallback;
740
+ }
741
+ if (typeof value !== "boolean") {
742
+ throw new TypeError("Opsi boolean harus berupa boolean");
743
+ }
744
+ return value;
745
+ }
746
+ function isValidUTCDateParts(year, month, day) {
747
+ if (year < 1e3 || year > 9999 || month < 1 || month > 12 || day < 1 || day > 31) {
748
+ return false;
749
+ }
750
+ const dt = new Date(Date.UTC(year, month - 1, day));
751
+ return dt.getUTCFullYear() === year && dt.getUTCMonth() === month - 1 && dt.getUTCDate() === day;
752
+ }
753
+ function parseDateOnlyParts(input) {
754
+ const match = DATE_ONLY_REGEX.exec(input);
755
+ if (!match) {
756
+ return null;
757
+ }
758
+ const tahun = Number(match[1]);
759
+ const bulan = Number(match[2]);
760
+ const tanggal = Number(match[3]);
761
+ if (!isValidUTCDateParts(tahun, bulan, tanggal)) {
762
+ throw new RangeError("Format tanggal atau waktu tidak valid");
763
+ }
764
+ const hari = new Date(Date.UTC(tahun, bulan - 1, tanggal)).getUTCDay();
765
+ return { tahun, bulan, tanggal, hari };
766
+ }
767
+ function parseInstantToUTCMs(input) {
768
+ if (input instanceof Date) {
769
+ const ms2 = input.getTime();
770
+ if (!Number.isFinite(ms2)) {
771
+ throw new RangeError("Format tanggal atau waktu tidak valid");
772
+ }
773
+ return ms2;
774
+ }
775
+ if (typeof input !== "string") {
776
+ throw new TypeError("Input harus berupa Date atau string ISO yang valid");
777
+ }
778
+ const match = ISO_OFFSET_REGEX.exec(input);
779
+ if (!match) {
780
+ throw new RangeError("Format tanggal atau waktu tidak valid");
781
+ }
782
+ const year = Number(match[1]);
783
+ const month = Number(match[2]);
784
+ const day = Number(match[3]);
785
+ const hour = Number(match[4]);
786
+ const minute = Number(match[5]);
787
+ const second = match[6] !== void 0 ? Number(match[6]) : 0;
788
+ const ms = match[7] !== void 0 ? Number(match[7].slice(0, 3).padEnd(3, "0")) : 0;
789
+ if (!isValidUTCDateParts(year, month, day) || hour > 23 || minute > 59 || second > 59) {
790
+ throw new RangeError("Format tanggal atau waktu tidak valid");
791
+ }
792
+ let offsetMinutes = 0;
793
+ if (match[8] !== void 0) {
794
+ const sign = match[8] === "+" ? 1 : -1;
795
+ const offHours = Number(match[9]);
796
+ const offMins = Number(match[10]);
797
+ if (offHours > 23 || offMins > 59) {
798
+ throw new RangeError("Format tanggal atau waktu tidak valid");
799
+ }
800
+ offsetMinutes = sign * (offHours * 60 + offMins);
801
+ }
802
+ return Date.UTC(year, month - 1, day, hour, minute, second, ms) - offsetMinutes * 6e4;
803
+ }
804
+ function formatDateParts(parts, denganHari, singkat) {
805
+ const bulanNama = singkat ? NAMA_BULAN_SINGKAT[parts.bulan - 1] : NAMA_BULAN[parts.bulan - 1];
806
+ const tanggalText = `${parts.tanggal} ${bulanNama} ${parts.tahun}`;
807
+ if (!denganHari) {
808
+ return tanggalText;
809
+ }
810
+ const hariNama = singkat ? NAMA_HARI_SINGKAT[parts.hari] : NAMA_HARI[parts.hari];
811
+ return `${hariNama}, ${tanggalText}`;
812
+ }
813
+ function formatTimeParts(parts, denganDetik, tampilkanZona) {
814
+ const base = denganDetik ? `${pad22(parts.jam)}:${pad22(parts.menit)}:${pad22(parts.detik)}` : `${pad22(parts.jam)}:${pad22(parts.menit)}`;
815
+ return tampilkanZona ? `${base} ${parts.zona}` : base;
816
+ }
817
+ function keZonaWaktu(input, zona = "WIB") {
818
+ const targetZona = validateZona(zona);
819
+ const utcMs = parseInstantToUTCMs(input);
820
+ const offsetHours = ZONA_OFFSET_HOURS[targetZona];
821
+ const shifted = new Date(utcMs + offsetHours * 36e5);
822
+ const tahun = shifted.getUTCFullYear();
823
+ const bulan = shifted.getUTCMonth() + 1;
824
+ const tanggal = shifted.getUTCDate();
825
+ const hari = shifted.getUTCDay();
826
+ const jam = shifted.getUTCHours();
827
+ const menit = shifted.getUTCMinutes();
828
+ const detik = shifted.getUTCSeconds();
829
+ const offset = ZONA_OFFSET_STRING[targetZona];
830
+ return {
831
+ tahun,
832
+ bulan,
833
+ tanggal,
834
+ hari,
835
+ jam,
836
+ menit,
837
+ detik,
838
+ zona: targetZona,
839
+ offset,
840
+ iso: `${pad4(tahun)}-${pad22(bulan)}-${pad22(tanggal)}T${pad22(jam)}:${pad22(menit)}:${pad22(detik)}${offset}`
841
+ };
842
+ }
843
+ function formatTanggal(input, options) {
844
+ assertOptionsObject(options);
845
+ const zona = validateZona(options?.zona);
846
+ const denganHari = assertOptionalBoolean(options?.denganHari, false);
847
+ const singkat = assertOptionalBoolean(options?.singkat, false);
848
+ if (typeof input === "string") {
849
+ const dateOnly = parseDateOnlyParts(input);
850
+ if (dateOnly) {
851
+ return formatDateParts(dateOnly, denganHari, singkat);
852
+ }
853
+ } else if (!(input instanceof Date)) {
854
+ throw new TypeError("Input harus berupa Date atau string tanggal yang valid");
855
+ }
856
+ const parts = keZonaWaktu(input, zona);
857
+ return formatDateParts(parts, denganHari, singkat);
858
+ }
859
+ function formatWaktu(input, options) {
860
+ assertOptionsObject(options);
861
+ const zona = validateZona(options?.zona);
862
+ const denganDetik = assertOptionalBoolean(options?.denganDetik, false);
863
+ const tampilkanZona = assertOptionalBoolean(options?.tampilkanZona, true);
864
+ const parts = keZonaWaktu(input, zona);
865
+ return formatTimeParts(parts, denganDetik, tampilkanZona);
866
+ }
867
+ function formatTanggalWaktu(input, options) {
868
+ assertOptionsObject(options);
869
+ const zona = validateZona(options?.zona);
870
+ const denganHari = assertOptionalBoolean(options?.denganHari, false);
871
+ const singkat = assertOptionalBoolean(options?.singkat, false);
872
+ const denganDetik = assertOptionalBoolean(options?.denganDetik, false);
873
+ const tampilkanZona = assertOptionalBoolean(options?.tampilkanZona, true);
874
+ const parts = keZonaWaktu(input, zona);
875
+ const tanggalText = formatDateParts(parts, denganHari, singkat);
876
+ const waktuText = formatTimeParts(parts, denganDetik, tampilkanZona);
877
+ return `${tanggalText}, ${waktuText}`;
878
+ }
879
+ function zonaWaktuProvinsi(kodeProvinsi) {
880
+ if (typeof kodeProvinsi !== "string") {
881
+ throw new TypeError("Kode provinsi harus berupa string");
882
+ }
883
+ const trimmed = kodeProvinsi.trim();
884
+ if (!/^\d{2}$/.test(trimmed)) {
885
+ return null;
886
+ }
887
+ return Object.prototype.hasOwnProperty.call(PROVINSI_ZONA, trimmed) ? PROVINSI_ZONA[trimmed] : null;
888
+ }
609
889
  // Annotate the CommonJS export names for ESM import in node:
610
890
  0 && (module.exports = {
611
891
  cekLibur,
612
892
  daftarLibur,
613
893
  detectOperator,
894
+ formatTanggal,
895
+ formatTanggalWaktu,
896
+ formatWaktu,
614
897
  getBank,
615
898
  isValidNIK,
616
899
  isValidNITKU,
617
900
  isValidNPWP,
618
901
  isValidPhone,
902
+ keZonaWaktu,
619
903
  listBank,
620
904
  mask,
621
905
  maskAccount,
@@ -627,5 +911,6 @@ function tahunTersedia() {
627
911
  parseNPWP,
628
912
  rupiah,
629
913
  tahunTersedia,
630
- terbilang
914
+ terbilang,
915
+ zonaWaktuProvinsi
631
916
  });
package/dist/index.d.cts CHANGED
@@ -5,3 +5,4 @@ export { MaskOptions, mask, maskAccount, maskNIK, maskPhone } from './mask.cjs';
5
5
  export { NPWPInvalidReason, NPWPJenis, ParseNITKUResult, ParseNPWPResult, isValidNITKU, isValidNPWP, parseNITKU, parseNPWP } from './npwp.cjs';
6
6
  export { BankInfo, getBank, listBank } from './bank.cjs';
7
7
  export { CekLiburResult, LiburItem, LiburJenis, cekLibur, daftarLibur, tahunTersedia } from './libur.cjs';
8
+ export { FormatTanggalOptions, FormatTanggalWaktuOptions, FormatWaktuOptions, WaktuIndonesia, ZonaWaktu, formatTanggal, formatTanggalWaktu, formatWaktu, keZonaWaktu, zonaWaktuProvinsi } from './waktu.cjs';
package/dist/index.d.ts CHANGED
@@ -5,3 +5,4 @@ export { MaskOptions, mask, maskAccount, maskNIK, maskPhone } from './mask.js';
5
5
  export { NPWPInvalidReason, NPWPJenis, ParseNITKUResult, ParseNPWPResult, isValidNITKU, isValidNPWP, parseNITKU, parseNPWP } from './npwp.js';
6
6
  export { BankInfo, getBank, listBank } from './bank.js';
7
7
  export { CekLiburResult, LiburItem, LiburJenis, cekLibur, daftarLibur, tahunTersedia } from './libur.js';
8
+ export { FormatTanggalOptions, FormatTanggalWaktuOptions, FormatWaktuOptions, WaktuIndonesia, ZonaWaktu, formatTanggal, formatTanggalWaktu, formatWaktu, keZonaWaktu, zonaWaktuProvinsi } from './waktu.js';
package/dist/index.js CHANGED
@@ -1,3 +1,10 @@
1
+ import {
2
+ formatTanggal,
3
+ formatTanggalWaktu,
4
+ formatWaktu,
5
+ keZonaWaktu,
6
+ zonaWaktuProvinsi
7
+ } from "./chunk-ZTRDEVGF.js";
1
8
  import {
2
9
  rupiah,
3
10
  terbilang
@@ -36,11 +43,15 @@ export {
36
43
  cekLibur,
37
44
  daftarLibur,
38
45
  detectOperator,
46
+ formatTanggal,
47
+ formatTanggalWaktu,
48
+ formatWaktu,
39
49
  getBank,
40
50
  isValidNIK,
41
51
  isValidNITKU,
42
52
  isValidNPWP,
43
53
  isValidPhone,
54
+ keZonaWaktu,
44
55
  listBank,
45
56
  mask,
46
57
  maskAccount,
@@ -52,5 +63,6 @@ export {
52
63
  parseNPWP,
53
64
  rupiah,
54
65
  tahunTersedia,
55
- terbilang
66
+ terbilang,
67
+ zonaWaktuProvinsi
56
68
  };
package/dist/waktu.cjs ADDED
@@ -0,0 +1,312 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/waktu/index.ts
21
+ var waktu_exports = {};
22
+ __export(waktu_exports, {
23
+ formatTanggal: () => formatTanggal,
24
+ formatTanggalWaktu: () => formatTanggalWaktu,
25
+ formatWaktu: () => formatWaktu,
26
+ keZonaWaktu: () => keZonaWaktu,
27
+ zonaWaktuProvinsi: () => zonaWaktuProvinsi
28
+ });
29
+ module.exports = __toCommonJS(waktu_exports);
30
+
31
+ // src/waktu/waktu.ts
32
+ var NAMA_HARI = [
33
+ "Minggu",
34
+ "Senin",
35
+ "Selasa",
36
+ "Rabu",
37
+ "Kamis",
38
+ "Jumat",
39
+ "Sabtu"
40
+ ];
41
+ var NAMA_HARI_SINGKAT = [
42
+ "Min",
43
+ "Sen",
44
+ "Sel",
45
+ "Rab",
46
+ "Kam",
47
+ "Jum",
48
+ "Sab"
49
+ ];
50
+ var NAMA_BULAN = [
51
+ "Januari",
52
+ "Februari",
53
+ "Maret",
54
+ "April",
55
+ "Mei",
56
+ "Juni",
57
+ "Juli",
58
+ "Agustus",
59
+ "September",
60
+ "Oktober",
61
+ "November",
62
+ "Desember"
63
+ ];
64
+ var NAMA_BULAN_SINGKAT = [
65
+ "Jan",
66
+ "Feb",
67
+ "Mar",
68
+ "Apr",
69
+ "Mei",
70
+ "Jun",
71
+ "Jul",
72
+ "Agu",
73
+ "Sep",
74
+ "Okt",
75
+ "Nov",
76
+ "Des"
77
+ ];
78
+ var ZONA_OFFSET_HOURS = {
79
+ WIB: 7,
80
+ WITA: 8,
81
+ WIT: 9
82
+ };
83
+ var ZONA_OFFSET_STRING = {
84
+ WIB: "+07:00",
85
+ WITA: "+08:00",
86
+ WIT: "+09:00"
87
+ };
88
+ var PROVINSI_ZONA = {
89
+ // WIB (Sumatra, Jawa, Kalimantan Barat, Kalimantan Tengah)
90
+ "11": "WIB",
91
+ "12": "WIB",
92
+ "13": "WIB",
93
+ "14": "WIB",
94
+ "15": "WIB",
95
+ "16": "WIB",
96
+ "17": "WIB",
97
+ "18": "WIB",
98
+ "19": "WIB",
99
+ "21": "WIB",
100
+ "31": "WIB",
101
+ "32": "WIB",
102
+ "33": "WIB",
103
+ "34": "WIB",
104
+ "35": "WIB",
105
+ "36": "WIB",
106
+ "61": "WIB",
107
+ "62": "WIB",
108
+ // WITA (Bali, Nusa Tenggara, Kalimantan Selatan/Timur/Utara, Sulawesi)
109
+ "51": "WITA",
110
+ "52": "WITA",
111
+ "53": "WITA",
112
+ "63": "WITA",
113
+ "64": "WITA",
114
+ "65": "WITA",
115
+ "71": "WITA",
116
+ "72": "WITA",
117
+ "73": "WITA",
118
+ "74": "WITA",
119
+ "75": "WITA",
120
+ "76": "WITA",
121
+ // WIT (Maluku, Maluku Utara, Papua & DOB Papua)
122
+ "81": "WIT",
123
+ "82": "WIT",
124
+ "91": "WIT",
125
+ "92": "WIT",
126
+ "93": "WIT",
127
+ "94": "WIT",
128
+ "95": "WIT",
129
+ "96": "WIT"
130
+ };
131
+ var DATE_ONLY_REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;
132
+ var ISO_OFFSET_REGEX = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?(?:[Zz]|([+-])(\d{2}):?(\d{2}))$/;
133
+ function pad2(n) {
134
+ return String(n).padStart(2, "0");
135
+ }
136
+ function pad4(n) {
137
+ return String(n).padStart(4, "0");
138
+ }
139
+ function validateZona(zona) {
140
+ if (zona === void 0) {
141
+ return "WIB";
142
+ }
143
+ if (zona !== "WIB" && zona !== "WITA" && zona !== "WIT") {
144
+ throw new RangeError("Zona waktu harus WIB, WITA, atau WIT");
145
+ }
146
+ return zona;
147
+ }
148
+ function assertOptionsObject(options) {
149
+ if (options !== void 0 && (typeof options !== "object" || options === null || Array.isArray(options))) {
150
+ throw new TypeError("Opsi harus berupa objek");
151
+ }
152
+ }
153
+ function assertOptionalBoolean(value, fallback) {
154
+ if (value === void 0) {
155
+ return fallback;
156
+ }
157
+ if (typeof value !== "boolean") {
158
+ throw new TypeError("Opsi boolean harus berupa boolean");
159
+ }
160
+ return value;
161
+ }
162
+ function isValidUTCDateParts(year, month, day) {
163
+ if (year < 1e3 || year > 9999 || month < 1 || month > 12 || day < 1 || day > 31) {
164
+ return false;
165
+ }
166
+ const dt = new Date(Date.UTC(year, month - 1, day));
167
+ return dt.getUTCFullYear() === year && dt.getUTCMonth() === month - 1 && dt.getUTCDate() === day;
168
+ }
169
+ function parseDateOnlyParts(input) {
170
+ const match = DATE_ONLY_REGEX.exec(input);
171
+ if (!match) {
172
+ return null;
173
+ }
174
+ const tahun = Number(match[1]);
175
+ const bulan = Number(match[2]);
176
+ const tanggal = Number(match[3]);
177
+ if (!isValidUTCDateParts(tahun, bulan, tanggal)) {
178
+ throw new RangeError("Format tanggal atau waktu tidak valid");
179
+ }
180
+ const hari = new Date(Date.UTC(tahun, bulan - 1, tanggal)).getUTCDay();
181
+ return { tahun, bulan, tanggal, hari };
182
+ }
183
+ function parseInstantToUTCMs(input) {
184
+ if (input instanceof Date) {
185
+ const ms2 = input.getTime();
186
+ if (!Number.isFinite(ms2)) {
187
+ throw new RangeError("Format tanggal atau waktu tidak valid");
188
+ }
189
+ return ms2;
190
+ }
191
+ if (typeof input !== "string") {
192
+ throw new TypeError("Input harus berupa Date atau string ISO yang valid");
193
+ }
194
+ const match = ISO_OFFSET_REGEX.exec(input);
195
+ if (!match) {
196
+ throw new RangeError("Format tanggal atau waktu tidak valid");
197
+ }
198
+ const year = Number(match[1]);
199
+ const month = Number(match[2]);
200
+ const day = Number(match[3]);
201
+ const hour = Number(match[4]);
202
+ const minute = Number(match[5]);
203
+ const second = match[6] !== void 0 ? Number(match[6]) : 0;
204
+ const ms = match[7] !== void 0 ? Number(match[7].slice(0, 3).padEnd(3, "0")) : 0;
205
+ if (!isValidUTCDateParts(year, month, day) || hour > 23 || minute > 59 || second > 59) {
206
+ throw new RangeError("Format tanggal atau waktu tidak valid");
207
+ }
208
+ let offsetMinutes = 0;
209
+ if (match[8] !== void 0) {
210
+ const sign = match[8] === "+" ? 1 : -1;
211
+ const offHours = Number(match[9]);
212
+ const offMins = Number(match[10]);
213
+ if (offHours > 23 || offMins > 59) {
214
+ throw new RangeError("Format tanggal atau waktu tidak valid");
215
+ }
216
+ offsetMinutes = sign * (offHours * 60 + offMins);
217
+ }
218
+ return Date.UTC(year, month - 1, day, hour, minute, second, ms) - offsetMinutes * 6e4;
219
+ }
220
+ function formatDateParts(parts, denganHari, singkat) {
221
+ const bulanNama = singkat ? NAMA_BULAN_SINGKAT[parts.bulan - 1] : NAMA_BULAN[parts.bulan - 1];
222
+ const tanggalText = `${parts.tanggal} ${bulanNama} ${parts.tahun}`;
223
+ if (!denganHari) {
224
+ return tanggalText;
225
+ }
226
+ const hariNama = singkat ? NAMA_HARI_SINGKAT[parts.hari] : NAMA_HARI[parts.hari];
227
+ return `${hariNama}, ${tanggalText}`;
228
+ }
229
+ function formatTimeParts(parts, denganDetik, tampilkanZona) {
230
+ const base = denganDetik ? `${pad2(parts.jam)}:${pad2(parts.menit)}:${pad2(parts.detik)}` : `${pad2(parts.jam)}:${pad2(parts.menit)}`;
231
+ return tampilkanZona ? `${base} ${parts.zona}` : base;
232
+ }
233
+ function keZonaWaktu(input, zona = "WIB") {
234
+ const targetZona = validateZona(zona);
235
+ const utcMs = parseInstantToUTCMs(input);
236
+ const offsetHours = ZONA_OFFSET_HOURS[targetZona];
237
+ const shifted = new Date(utcMs + offsetHours * 36e5);
238
+ const tahun = shifted.getUTCFullYear();
239
+ const bulan = shifted.getUTCMonth() + 1;
240
+ const tanggal = shifted.getUTCDate();
241
+ const hari = shifted.getUTCDay();
242
+ const jam = shifted.getUTCHours();
243
+ const menit = shifted.getUTCMinutes();
244
+ const detik = shifted.getUTCSeconds();
245
+ const offset = ZONA_OFFSET_STRING[targetZona];
246
+ return {
247
+ tahun,
248
+ bulan,
249
+ tanggal,
250
+ hari,
251
+ jam,
252
+ menit,
253
+ detik,
254
+ zona: targetZona,
255
+ offset,
256
+ iso: `${pad4(tahun)}-${pad2(bulan)}-${pad2(tanggal)}T${pad2(jam)}:${pad2(menit)}:${pad2(detik)}${offset}`
257
+ };
258
+ }
259
+ function formatTanggal(input, options) {
260
+ assertOptionsObject(options);
261
+ const zona = validateZona(options?.zona);
262
+ const denganHari = assertOptionalBoolean(options?.denganHari, false);
263
+ const singkat = assertOptionalBoolean(options?.singkat, false);
264
+ if (typeof input === "string") {
265
+ const dateOnly = parseDateOnlyParts(input);
266
+ if (dateOnly) {
267
+ return formatDateParts(dateOnly, denganHari, singkat);
268
+ }
269
+ } else if (!(input instanceof Date)) {
270
+ throw new TypeError("Input harus berupa Date atau string tanggal yang valid");
271
+ }
272
+ const parts = keZonaWaktu(input, zona);
273
+ return formatDateParts(parts, denganHari, singkat);
274
+ }
275
+ function formatWaktu(input, options) {
276
+ assertOptionsObject(options);
277
+ const zona = validateZona(options?.zona);
278
+ const denganDetik = assertOptionalBoolean(options?.denganDetik, false);
279
+ const tampilkanZona = assertOptionalBoolean(options?.tampilkanZona, true);
280
+ const parts = keZonaWaktu(input, zona);
281
+ return formatTimeParts(parts, denganDetik, tampilkanZona);
282
+ }
283
+ function formatTanggalWaktu(input, options) {
284
+ assertOptionsObject(options);
285
+ const zona = validateZona(options?.zona);
286
+ const denganHari = assertOptionalBoolean(options?.denganHari, false);
287
+ const singkat = assertOptionalBoolean(options?.singkat, false);
288
+ const denganDetik = assertOptionalBoolean(options?.denganDetik, false);
289
+ const tampilkanZona = assertOptionalBoolean(options?.tampilkanZona, true);
290
+ const parts = keZonaWaktu(input, zona);
291
+ const tanggalText = formatDateParts(parts, denganHari, singkat);
292
+ const waktuText = formatTimeParts(parts, denganDetik, tampilkanZona);
293
+ return `${tanggalText}, ${waktuText}`;
294
+ }
295
+ function zonaWaktuProvinsi(kodeProvinsi) {
296
+ if (typeof kodeProvinsi !== "string") {
297
+ throw new TypeError("Kode provinsi harus berupa string");
298
+ }
299
+ const trimmed = kodeProvinsi.trim();
300
+ if (!/^\d{2}$/.test(trimmed)) {
301
+ return null;
302
+ }
303
+ return Object.prototype.hasOwnProperty.call(PROVINSI_ZONA, trimmed) ? PROVINSI_ZONA[trimmed] : null;
304
+ }
305
+ // Annotate the CommonJS export names for ESM import in node:
306
+ 0 && (module.exports = {
307
+ formatTanggal,
308
+ formatTanggalWaktu,
309
+ formatWaktu,
310
+ keZonaWaktu,
311
+ zonaWaktuProvinsi
312
+ });
@@ -0,0 +1,67 @@
1
+ type ZonaWaktu = "WIB" | "WITA" | "WIT";
2
+ interface FormatTanggalOptions {
3
+ /** Zona waktu target untuk konversi input instan (`Date` atau ISO ber-offset). Default: `"WIB"`. */
4
+ zona?: ZonaWaktu;
5
+ /** Sertakan nama hari di depan tanggal (contoh: `"Rabu, 18 November 2026"`). Default: `false`. */
6
+ denganHari?: boolean;
7
+ /** Gunakan nama bulan/hari singkat 3 huruf (contoh: `"18 Nov 2026"`). Default: `false`. */
8
+ singkat?: boolean;
9
+ }
10
+ interface FormatWaktuOptions {
11
+ /** Zona waktu target. Default: `"WIB"`. */
12
+ zona?: ZonaWaktu;
13
+ /** Sertakan detik (contoh: `"20:35:10 WIB"`). Default: `false`. */
14
+ denganDetik?: boolean;
15
+ /** Sertakan label zona waktu di belakang jam. Default: `true`. */
16
+ tampilkanZona?: boolean;
17
+ }
18
+ interface FormatTanggalWaktuOptions extends FormatTanggalOptions, FormatWaktuOptions {
19
+ }
20
+ interface WaktuIndonesia {
21
+ readonly tahun: number;
22
+ readonly bulan: number;
23
+ readonly tanggal: number;
24
+ readonly hari: number;
25
+ readonly jam: number;
26
+ readonly menit: number;
27
+ readonly detik: number;
28
+ readonly zona: ZonaWaktu;
29
+ readonly offset: "+07:00" | "+08:00" | "+09:00";
30
+ readonly iso: string;
31
+ }
32
+ /**
33
+ * Mengonversi `Date` atau string ISO ber-offset eksplisit (`Z` / `±HH:MM`) ke zona waktu Indonesia
34
+ * (`WIB`, `WITA`, atau `WIT`) menggunakan aritmetika UTC murni tanpa bergantung pada zona waktu mesin lokal.
35
+ */
36
+ declare function keZonaWaktu(input: Date | string, zona?: ZonaWaktu): WaktuIndonesia;
37
+ /**
38
+ * Memformat tanggal ke bahasa Indonesia (contoh: `"18 November 2026"` atau `"Rabu, 18 November 2026"`).
39
+ *
40
+ * Menerima `Date`, string ISO dengan zona waktu eksplisit (`Z` / `±HH:MM`), atau string tanggal murni
41
+ * `"YYYY-MM-DD"` (dianggap tanggal kalender tanpa pergeseran jam). String ISO tanpa offset ditolak.
42
+ */
43
+ declare function formatTanggal(input: Date | string, options?: FormatTanggalOptions): string;
44
+ /**
45
+ * Memformat waktu (jam) ke zona waktu Indonesia dengan pemisah titik dua (contoh: `"20:35 WIB"`).
46
+ *
47
+ * Menerima `Date` atau string ISO dengan zona waktu eksplisit (`Z` / `±HH:MM`).
48
+ * String `"YYYY-MM-DD"` dan string ISO tanpa offset ditolak dengan `RangeError`.
49
+ */
50
+ declare function formatWaktu(input: Date | string, options?: FormatWaktuOptions): string;
51
+ /**
52
+ * Memformat tanggal dan waktu sekaligus ke zona waktu Indonesia
53
+ * (contoh: `"18 November 2026, 20:35 WIB"`).
54
+ *
55
+ * Menerima `Date` atau string ISO dengan zona waktu eksplisit (`Z` / `±HH:MM`).
56
+ */
57
+ declare function formatTanggalWaktu(input: Date | string, options?: FormatTanggalWaktuOptions): string;
58
+ /**
59
+ * Mengembalikan zona waktu (`"WIB"`, `"WITA"`, atau `"WIT"`) berdasarkan kode provinsi 2 digit
60
+ * Kemendagri (`"11"`–`"96"`), konsisten dengan kode provinsi pada modul `nik`, atau `null` jika tidak dikenal.
61
+ *
62
+ * Catatan: menggunakan 38 kode provinsi Kemendagri (`"11"`–`"96"`), bukan kode wilayah kerja statistik
63
+ * BPS yang berbeda penomoran di wilayah Papua.
64
+ */
65
+ declare function zonaWaktuProvinsi(kodeProvinsi: string): ZonaWaktu | null;
66
+
67
+ export { type FormatTanggalOptions, type FormatTanggalWaktuOptions, type FormatWaktuOptions, type WaktuIndonesia, type ZonaWaktu, formatTanggal, formatTanggalWaktu, formatWaktu, keZonaWaktu, zonaWaktuProvinsi };
@@ -0,0 +1,67 @@
1
+ type ZonaWaktu = "WIB" | "WITA" | "WIT";
2
+ interface FormatTanggalOptions {
3
+ /** Zona waktu target untuk konversi input instan (`Date` atau ISO ber-offset). Default: `"WIB"`. */
4
+ zona?: ZonaWaktu;
5
+ /** Sertakan nama hari di depan tanggal (contoh: `"Rabu, 18 November 2026"`). Default: `false`. */
6
+ denganHari?: boolean;
7
+ /** Gunakan nama bulan/hari singkat 3 huruf (contoh: `"18 Nov 2026"`). Default: `false`. */
8
+ singkat?: boolean;
9
+ }
10
+ interface FormatWaktuOptions {
11
+ /** Zona waktu target. Default: `"WIB"`. */
12
+ zona?: ZonaWaktu;
13
+ /** Sertakan detik (contoh: `"20:35:10 WIB"`). Default: `false`. */
14
+ denganDetik?: boolean;
15
+ /** Sertakan label zona waktu di belakang jam. Default: `true`. */
16
+ tampilkanZona?: boolean;
17
+ }
18
+ interface FormatTanggalWaktuOptions extends FormatTanggalOptions, FormatWaktuOptions {
19
+ }
20
+ interface WaktuIndonesia {
21
+ readonly tahun: number;
22
+ readonly bulan: number;
23
+ readonly tanggal: number;
24
+ readonly hari: number;
25
+ readonly jam: number;
26
+ readonly menit: number;
27
+ readonly detik: number;
28
+ readonly zona: ZonaWaktu;
29
+ readonly offset: "+07:00" | "+08:00" | "+09:00";
30
+ readonly iso: string;
31
+ }
32
+ /**
33
+ * Mengonversi `Date` atau string ISO ber-offset eksplisit (`Z` / `±HH:MM`) ke zona waktu Indonesia
34
+ * (`WIB`, `WITA`, atau `WIT`) menggunakan aritmetika UTC murni tanpa bergantung pada zona waktu mesin lokal.
35
+ */
36
+ declare function keZonaWaktu(input: Date | string, zona?: ZonaWaktu): WaktuIndonesia;
37
+ /**
38
+ * Memformat tanggal ke bahasa Indonesia (contoh: `"18 November 2026"` atau `"Rabu, 18 November 2026"`).
39
+ *
40
+ * Menerima `Date`, string ISO dengan zona waktu eksplisit (`Z` / `±HH:MM`), atau string tanggal murni
41
+ * `"YYYY-MM-DD"` (dianggap tanggal kalender tanpa pergeseran jam). String ISO tanpa offset ditolak.
42
+ */
43
+ declare function formatTanggal(input: Date | string, options?: FormatTanggalOptions): string;
44
+ /**
45
+ * Memformat waktu (jam) ke zona waktu Indonesia dengan pemisah titik dua (contoh: `"20:35 WIB"`).
46
+ *
47
+ * Menerima `Date` atau string ISO dengan zona waktu eksplisit (`Z` / `±HH:MM`).
48
+ * String `"YYYY-MM-DD"` dan string ISO tanpa offset ditolak dengan `RangeError`.
49
+ */
50
+ declare function formatWaktu(input: Date | string, options?: FormatWaktuOptions): string;
51
+ /**
52
+ * Memformat tanggal dan waktu sekaligus ke zona waktu Indonesia
53
+ * (contoh: `"18 November 2026, 20:35 WIB"`).
54
+ *
55
+ * Menerima `Date` atau string ISO dengan zona waktu eksplisit (`Z` / `±HH:MM`).
56
+ */
57
+ declare function formatTanggalWaktu(input: Date | string, options?: FormatTanggalWaktuOptions): string;
58
+ /**
59
+ * Mengembalikan zona waktu (`"WIB"`, `"WITA"`, atau `"WIT"`) berdasarkan kode provinsi 2 digit
60
+ * Kemendagri (`"11"`–`"96"`), konsisten dengan kode provinsi pada modul `nik`, atau `null` jika tidak dikenal.
61
+ *
62
+ * Catatan: menggunakan 38 kode provinsi Kemendagri (`"11"`–`"96"`), bukan kode wilayah kerja statistik
63
+ * BPS yang berbeda penomoran di wilayah Papua.
64
+ */
65
+ declare function zonaWaktuProvinsi(kodeProvinsi: string): ZonaWaktu | null;
66
+
67
+ export { type FormatTanggalOptions, type FormatTanggalWaktuOptions, type FormatWaktuOptions, type WaktuIndonesia, type ZonaWaktu, formatTanggal, formatTanggalWaktu, formatWaktu, keZonaWaktu, zonaWaktuProvinsi };
package/dist/waktu.js ADDED
@@ -0,0 +1,14 @@
1
+ import {
2
+ formatTanggal,
3
+ formatTanggalWaktu,
4
+ formatWaktu,
5
+ keZonaWaktu,
6
+ zonaWaktuProvinsi
7
+ } from "./chunk-ZTRDEVGF.js";
8
+ export {
9
+ formatTanggal,
10
+ formatTanggalWaktu,
11
+ formatWaktu,
12
+ keZonaWaktu,
13
+ zonaWaktuProvinsi
14
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ghifari29/id-kit",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "description": "Utilitas Indonesia: terbilang, rupiah, nomor telepon, dan lainnya",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -50,6 +50,11 @@
50
50
  "types": "./dist/libur.d.ts",
51
51
  "import": "./dist/libur.js",
52
52
  "require": "./dist/libur.cjs"
53
+ },
54
+ "./waktu": {
55
+ "types": "./dist/waktu.d.ts",
56
+ "import": "./dist/waktu.js",
57
+ "require": "./dist/waktu.cjs"
53
58
  }
54
59
  },
55
60
  "scripts": {