Perhitungan dan Pemformatan Tanggal PHP untuk Bahasa Indonesia
OstiumDate adalah sebuah library perhitungan dan pemformatan tanggal yang diperuntukkan khusus untuk Bahasa Indonesia. Fungsi perhitungan tanggal pada library ini menggunakan fungsi bawaan PHP yang disederhanakan agar lebih mudah digunakan.
Buat object untuk class OstiumDate
$od = new OstiumDate();
Mencetak tanggal dengan tampilan lengkap:
$od->fullDate() # argumen kosong menampilkan hari ini
# Output: Rabu, 13 Juni 2018
$od->fullDate('', '', '', false) # menampilkan hari ini tanpa disertai nama hari
# Output: 13 Juni 2018
$od->fullDate(2, 3, 2017)
# Output: Kamis, 2 Maret 2017
Mencetak tanggal dengan tampilan ringkas:
$od->shortDate() # argumen kosong menampilkan hari ini denga pemisah tanggal default '-'
# Output: 13-06-2018
$od->shortDate(2, 3, 2017, '/') # dengan pemisah tanggal sesuai input
# Output: 02/03/2017
Mencetak tanggal dengan custom format:
Terdapat 2 method untuk memformat tanggal secara kustom, yaitu
dengan $od->format() dan $od->create(). Kami menyarankan anda untuk
menggunakan method $od->create() yang sudah menyesuaikan dengan standar
format tanggal yang dihasilkan PHP sehingga anda tidak perlu menggunakan
fungsi reverse() terlebih dahulu untuk mengolah tanggal yang dihasilkan
oleh PHP ke dalam OstiumDate. Sementara method $od->format() akan dihapus pada versi
berikutnya dari OstiumDate.
Format tanggal khusus dengan pilihan format d, D, DD, m, M, MM, Y
Contoh: 'd' = 26, 'D' = Sen, 26, 'DD' = Senin, 26
'm' = 12, 'M' = Des, MM = Desember, y atau Y = 2016
Contoh eksekusi:
$od->format('D-M-Y', '1-9-2016', '-')
=== atau ===
$od->create('2016-09-01', 'D-M-Y', '-')
# Output: Kam, 1-Sep-2016
$od->format('DD-MM-Y', '1-9-2016', '-')
=== atau ===
$od->create('2016-09-01', 'DD-MM-Y', '-')
# Output: Kamis, 1-September-2016
$od->format('d-MM-Y', '1-9-2016')
=== atau ===
$od->create('2016-09-01', 'd-MM-Y')
# dengan pemisah tanggal default menggunakan spasi
# Output: 1 September 2016
Dengan method create(), anda bisa membiarkan semua argumen kosong
untuk menampilkan tanggal hari ini dengan format dan pemisah default.
$od->create()
# Output: 20 Oktober 2022
Menambahkan jumlah hari/bulan/tahun:
# Menambahkan 4 hari dari hari ini
$add = $od->add('now', 4);
echo $od->format('DD-MM-Y', $add);
# Output: Minggu, 17 Juni 2018
# Menambahkan 3 bulan 10 hari dari tanggal 1 Januari 2012
$add = $od->add('01-01-2012', ['m' => 3, 'd' => 10]);
echo $od->format('DD-MM-y', $add);
# Output: Rabu, 11 April 2012
# Menambahkan 2 tahun 3 bulan 10 hari dari tanggal 1 Januari 2012
$add = $od->add('01-01-2012', ['y' => 2, 'm' => 3, 'd' => 10]);
echo $od->format('DD-MM-y', $add);
# Output: Jumat, 11 April 2014
Mengurangi jumlah hari/bulan/tahun:
# Mengurangi 4 hari dari hari ini
$sub = $od->sub('now', 4);
echo $od->format('DD-MM-Y', $sub);
# Output: Sabtu, 9 Juni 2018
# Mengurangi 3 bulan 10 hari dari tanggal 1 Januari 2012
$sub = $od->sub('01-01-2012', ['m' => 3, 'd' => 10]);
echo $od->format('DD-MM-y', $sub);
# Output: Rabu, 21 September 2011
# Mengurangi 2 tahun 3 bulan 10 hari dari tanggal 1 Januari 2012
$sub = $od->sub('01-01-2012', ['y' => 2, 'm' => 3, 'd' => 10]);
echo $od->format('DD-MM-y', $sub);
# Output: Senin, 21 September 2009
Menghitung selisih hari/bulan/tahun:
Tipe output:
'pn-days' = positive-negative days, menghasilkan format output '%R%a hari'
'total-days' = '%a hari'
'num-only' = '%a'
'month' = '%m bulan'
'year' = '%y tahun'
'y-m-d' = '%y tahun, %m bulan, %d hari'
'm-d' = '%m bulan, %d hari'
'y-d' = '%y tahun, %d hari'
'y-m' = '%y tahun, %m bulan'
Detil format: http://php.net/manual/en/dateinterval.format.php
Eksekusi:
echo $od->diff('01-01-2013', '02-05-2015', 'pn-days', 'a-b');
# Output: +121 hari
echo $od->diff('01-01-2013', '02-05-2015', 'pn-days', 'b-a');
# Output: -121 hari
echo $od->diff('01-01-2013', '02-05-2015', 'total-days');
# Output: 121 hari
echo $od->diff('01-01-2013', '02-05-2015', 'y-m-d');
# Output: 2 tahun, 4 bulan, 1 hari