README

PHP日期计算和格式化（适用于印度尼西亚语）

描述

OstiumDate 是一个专为印度尼西亚语设计的日期计算和格式化库。该库中的日期计算功能使用了简化后的PHP内置函数，以便更易于使用。

如何安装

使用composer

composer require rzlco666/ostium-date

工作原理

创建OstiumDate类的对象

$od = new OstiumDate();

打印完整格式的日期

$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

打印简略格式的日期

$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

使用自定义格式打印日期

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', '-')
# Output: Kam, 1-Sep-2016

$od->format('DD-MM-Y', '1-9-2016', '-')
# Output: Kamis, 1-September-2016

$od->format('d-MM-Y', '1-9-2016') # dengan pemisah tanggal default menggunakan spasi
# Output: 1 September 2016

增加天数/月数/年数

# 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 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

计算天数/月数/年数的差值

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'

格式详情: https://php.ac.cn/manual/en/dateinterval.format.php
执行

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