irfa/php-hari-libur

"本插件用于检查国家法定假日"

v1.21 2021-05-28 02:58 UTC

This package is auto-updated.

Last update: 2024-09-28 10:21:57 UTC


README

Maintainability Scrutinizer Code Quality Support me ko-fi

本插件用于检查国家法定假日,目前仅适用于印度尼西亚的国家法定假日。

本插件中的法定假日每年都会更新。

🛠️ 使用 Composer 安装

composer require irfa/php-hari-libur

您可以从 这里 获取 Composer

更新此包

composer update irfa/php-hari-libur

🛠️ Laravel 配置

添加到 config/app.php

'providers' => [
    ....
    Irfa\HariLibur\HariLiburServiceProvider::class,
     ];

添加到 config/app.php

'aliases' => [
         ....
        'HariLibur' => Irfa\HariLibur\Facades\HariLibur::class,

    ],

发布供应商

php artisan vendor:publish --tag=hari-libur

Laravel 配置

config/irfa/hari_libur.php

非 Laravel 配置

/vendor/irfa/php-hari-libur/config/hari_libur.php

如果您使用 Laravel 框架,可以更改或添加假日到 resources/data-libur-nasional/XX.json,而如果您使用 PHP 原生或非 Laravel,则可以更改它到 vendor/irfa/php-hari-libur/src/Data/XX.json

使用方法

调用 HariLibur 类

PHP 原生 / 非 Laravel

use Irfa\HariLibur\Func\HariLibur;

在 Laravel 中也可以使用此方法

use Irfa\HariLibur\Facades\HariLibur;
atau
use HariLibur;

如果您使用 PHP 原生或非 Laravel,以下为示例用法

use Irfa\HariLibur\Func\HariLibur;
....
$libur = new HariLibur();
var_dump($libur->date("17-08-2021")->isHoliday());

检查选定日期的国家法定假日

HariLibur::date("17-08-2021")->isHoliday();
//return true

示例用法

if(HariLibur::date("17-08-2021")->isHoliday())
{
    echo "Waktunya liburan.";
} else {
    echo "Waktunya bekerja.";
}

检查选定日期的周末法定假日

HariLibur::date("17-03-2021")->isWeekend();
//return false

示例用法

if(HariLibur::date("17-08-2021")->isWeekend())
{
    echo "Selamat berakhir pekan.";
} else {
    echo "Waktunya bekerja.";
}

检查选定日期的法定假日

此函数是上述函数的组合。用于检查红色日期和周末。

HariLibur::date("17-08-2021")->isDayOff();
//return true

获取选定日期前后的国家法定假日

HariLibur::date("17-08-2021")->nextHoliday(); 
// mengambil data hari libur setelah tanggal 17-03-2021
HariLibur::date("17-08-2021")->prevHoliday(); 
// mengambil data hari libur setelah tanggal 17-03-2021

示例用法

$date = HariLibur::date("17-08-2021");
//mengambil data hari libur sebelum tangal 17-08-2021
foreach ($date->nextHoliday() as $hariLibur) {
    echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."<br>";
  }
//mengambil data hari libur sesudah tangal 17-08-2021
foreach ($date->prevHoliday() as $hariLibur) {
    echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."<br>";
  }

获取假日数据

获取配置中设置的区域内所有国家法定假日数据

HariLibur::get();

示例用法

foreach (HariLibur::get() as $hariLibur) {
		echo "Tanggal: ".$hariLibur->date." Deskripsi: ".$hariLibur->description."<br>";
	}

获取选定日期的假日信息

HariLibur::date("17-08-2021")->getInfo();
//return Hari Kemerdekaan Republik Indonesia

程序化设置区域

HariLibur::regional("ID")->get();

删除插件

composer remove irfa/php-hari-libur

删除成功后,如果使用 Laravel 框架,还有额外的步骤

  1. 打开 config/app.php
  2. 查找 providers 然后删除 Irfa\HariLibur\HariLiburServiceProvider::class
  3. 查找 aliases 然后删除 'HariLibur' => Irfa\HariLibur\Facades\HariLibur::class,
  4. 保存。

如何贡献?

  1. Fork 它 (https://github.com/irfaardy/php-hari-libur/fork)
  2. 提交您的更改 (git commit -m 'New Feature')
  3. 将更改推送到分支 (git push origin your-branch)
  4. 创建新的 Pull Request your-branch -> master

如果您发现错误或错误,请在这里发布 https://github.com/irfaardy/php-hari-libur/issues 以便它们可以一起维护。

如何贡献?

  1. 在 (https://github.com/irfaardy/php-hari-libur/fork) 进行 fork
  2. 提交您所做的更改 (git commit -m 'Fitur Baru')
  3. 将更改推送到 master 分支 (git push origin branch-kamu)
  4. 创建新的 Pull Request branch-kamu -> master

问题

如果您发现问题或错误,请在此处创建新的问题 https://github.com/irfaardyphp-hari-libur/issues/new

如果您发现错误或错误,请在此处发布 https://github.com/irfaardy/php-hari-libur/issues 以便它们可以一起修复。

印度尼西亚国家法定假日来源:https://kalenderindonesia.com/libur/masehi/2021#

许可证
GitHub license