Mengenal Api Kalender - KalenderIndonesia.Com

Bagikan:  

Anda Mungkin Tertarik


Oleh  :  Novian Agung
Pada  :   Januari  2019 21:22 | 1  جُمادى الأولى  1440 21:22 | 29  Bakda Mulud  1952 21:22 | 8k  Palguna  1955 21:22 | 17  Kasa  1941 21:22
Kategori  :  Situs Web
Gambar 1

Seperti sudah dijelaskan pada artikel yang lalu, API (Application Programming Interface), bahwasanya format konten yang dihasilkan oleh pemanggilan fungsi API berbentuk JSON (JavaScript Object Notation). Berikut ini akan saya jelaskan struktur obyek dari JSON yang dihasilkan oleh API kalender.

Urutan paling atas terdapat dua buah obyek yaitu Month dan Translate. Pada API kalender tahunan, obyek Month merupakan senarai (array) yang berisi 12 obyek yang merupakan informasi bulanan. Sementara pada API kalender bulanan bukanlah merupakan senarai namun tetap merupakan obyek berisi informasi bulanan khusus untuk bulan berlaku (yang ditentukan saat pemanggilan API). Sementara obyek Translate berisi daftar informasi kode hari libur yang nilainya merupakan nama dari hari libur.

Gambar 2

Pada sebuah obyek Month akan terdapat informasi berikut ini:

Nama Kunci Keterangan
DaysCount

Jumlah banyaknya hari pada bulan berlaku

WeeksCount

Jumlah banyaknya minggu pada bulan berlaku

Firstweek

Minggu pertama dari tanggal awal bulan. Misalnya untuk bulan Januari 2019 bernilai 2 (dua), artinya tanggal 1 Januari 2019 jatuh pada hari ke tiga dalam satu minggu, yaitu hari Selasa. Senarai daftar hari dalam satu minggu diawali dengan nilai 0 (nol) untuk hari Ahad/Minggu dan diakhiri nilai 6 (enam) untuk hari Sabtu, selengkapnya: 0-Ahad, 1-Senin, 2-Selasa, 3-Rabu, 4-Kamis, 5-Jum'at, 6-Sabtu

FirstDate

Tanggal awal dari bulan berlaku. Merupakan sebuah obyek yang mempunyai atribut lain di dalamnya, diantaranya M(asehi), H(ijriyah), J(awa), C(andra), S(surya). Misalnya untuk bulan Januari 2019, nilai H adalah "1440-04-24", artinya tanggal 1 Januari bertepatan dengan tanggal 24 bulan ke-4 (Rabbiul Akhir) tahun 1440 kalender Hijriyah

LastDate

Tanggal awal dari bulan berlaku. Merupakan sebuah obyek yang mempunyai atribut lain di dalamnya, diantaranya M(asehi), H(ijriyah), J(awa), C(andra), S(surya). Misalnya untuk bulan Januari 2019, nilai J adalah "1952-05-24", artinya tanggal 31 Januari bertepatan dengan tanggal 24 bulan ke-5 (Jumadi Awal) tahun 1952 kalender Jawa

Dates

Merupakan obyek yang merupakan senarai obyek yang berisi informasi setiap tanggal dari bulan berlaku. Daftar obyek dari Dates akan dijelaskan pada tabel berikutnya.

Gambar 3

Obyek Dates berupa senarai dengan jumlah item 42 yang dimulai dari indeks 0 (nol) sampai 41. Jika diimplementasikan ke dalam suatu tabel, sejumlah item senarai tersebut akan menciptakan sebuah tabel yang memiliki 7 buah kolom dan 6 buah baris, di mana 7 kolom tersebut merupakan jumlah hari dalam satu minggu.

Gambar 4

Berikut ini informasi yang terkandung pada item senarai obyek Dates.

Nama Kunci Keterangan
M

Tanggal kalender Masehi

H

Tanggal kalender Hijriyah

J

Tanggal kalender Jawa

C

Tanggal kalender Sunda Candra

S

Tanggal kalender Sunda Surya

W

Weekday, hari ke-n dalam satu minggu, sama seperti "Firstweek", dengan urutan sebagai berikut: 0-Ahad, 1-Senin, 2-Selasa, 3-Rabu, 4-Kamis, 5-Jum'at, 6-Sabtu

Type

Merupakan tipe tanggal, mempunyai tiga buah opsi, yaitu: "before", "current", dan "after". Tipe "before" menununjukkan bahwa tanggal tersebut merupakan tanggal bulan sebelumnya dari bulan bersangkutan. Tipe "current" menununjukkan bahwa tanggal tersebut merupakan tanggal bulan bersangkutan. Dan tipe "after" menununjukkan bahwa tanggal tersebut merupakan tanggal bulan setelahnya dari bulan bersangkutan. Pada tampilan kalender pada situs ini, tanggal dengan tipe "before" dan "after" akan ditandai dengan warna latar belakang abu-abu

Holiday

Berupa senarai yang menampilkan informasi hari-hari libur pada tanggal bersangkutan. Item senarai berupa sebuah obyek dengan informasi yang akan dijelaskan pada bahasan selanjutnya.

Leave

Berupa senarai, mirip dengan "Holiday", yang menampilkan informasi hari-hari cuti bersama pada tanggal bersangkutan. Item senarai berupa sebuah obyek dengan informasi yang hampir mirip dengan "Holiday"

Islamic

Berupa senarai, ini juga mirip dengan "Holiday", yang menampilkan informasi hari-hari penting/peringatan Islami/Hijriyah pada tanggal bersangkutan. Item senarai berupa sebuah obyek dengan informasi yang hampir mirip dengan "Holiday"

Info

Berisi info tambahan dari tanggal bersangkutan, berbentuk obyek dengan item obyek, yaitu: M(asehi) yang menampilkan info seputar/berkaitan dengan kalender Masehi, diantaranya: Zodiac, Shio, Elemen. J(awa) menampilkan info seputar/berkaitan dengan kalender Jawa, diantaranya: Pasaran, Wuku, Neptu, Mongso, Tahun, Windu, Lambang. S(unda) menampilkan info seputar/berkaitan dengan kalender Sunda, diantaranya: Pasaran, Wuku, Tahun, Windu

Berikut ini kode/indeks daftar Zodiac, Shio, Elemen pada API.

Index Zodiac Shio Elemen
0 Aries Ayam
1 Taurus Anjing Kayu
2 Gemini Babi Api
3 Kanser Tikus Tanah
4 Leo Kerbau Logam
5 Virgo Harimau Air
6 Libra Kelinci
7 Scorpio Naga
8 Sagitarius Ular
9 Kaprikornus Kuda
10 Akuarius Kambing
11 Pises Monyet

Pada dasarnya, API Kalender ini sudah mencakup daftar hari libur dari beberapa negara yang kami pilih, di antaranya: Indonesia (id), Malaysia (my), Brunai (bn), Singapura (sg), Filippina (ph), Vietnam (vn), China (cn), serta Amerika Serikat (us). Berikut ini informasi yang dimiliki oleh obyek Holiday, Leave, dan Islamic.

Nama Kunci Keterangan
Name

Kode hari libur, misalnya: "hijri_0001". Nama/keterangan untuk kode hari libur dapat dilihat pada obyek Translate pada pembahasan di atas

Info

Menampilkan informasi pelengkap dari hari libur bersangkutan, misalnya: 1440 Hijriyah, 1941 Saka, dan sebagainya

Type

Hampir mirip dengan "Name" yaitu berupa kode hari libur, hanya saja tipe ditambahi akhiran "a" atau "b" pada akhir kode. Akhiran "a" berarti sebelum hari libur utama, misalnya: "hijri_0009a" untuk menunjukkan cuti bersama sebelum Hari Raya Idul Fitri. Sedangkan akhiran "b" berarti setelah hari libur utama

Status

Status hari libur bersangkutan, terdiri dari tiga opsi: 0-Obervasi, 1-Libur Nasional, 2-Libur Pengganti. Untuk libur nasional di Indonesia, silakan abaikan Status dengan nilai 0 (nol) dan 1 (satu)

Rel

Menunjukan jenis atau kelompok hari libur, akan bernilai: "Masehi", "Hijriyah", "Buddha", "Hindu", "China"

Country

Berupa senarai untuk menentukan negara-negara yang memperingati hari libur bersangkutan, nama negara akan ditulis dalam kode negara internasional yang terdiri dari 2 (dua) huruf. Kode-kode negara sudah dituliskan di bagian atas

Exclude

Jika hari libur merupakan hari libur internasional, informasi yang berupa senarai ini akan menentukan negara-negara yang tidak memperingati hari libur bersangkutan, nama negara akan ditulis dalam kode negara internasional.

StateIn

Khusus untuk hari libur yang diperingati oleh negara yang memiliki negara bagian, seperti Malaysia, dan Amerika Serikat. StateIn berisi senarai daftar negara bagian yang memperingati hari libur bersangkutan

StateEx

Sama seperti "StateIn", hanya saja senarai berisi daftar negara bagian yang tidak memperingati hari libur bersangkutan

Gambar 5

Agar tidak membingungkan dalam membaca obyek Holiday, untuk mengambil hari libur nasional Indonesia, pastikan untuk mengecek nilai pada "Status", pilih hanya yang bernilai 1 (satu), serta periksa pada senarai "Country", pastikan terdapat kode negara Indonesia, yaitu "id". Bila ada pertanyaan seputar pembacaan hasil API, silakan menuju halaman Kontak untuk pertanyaan.

 Aplikasi Android

banner

 Iklan

 Stats