使用cmixin/business-time轻松处理Carbon的工作时间和节假日-composer-PHP中文网

使用cmixin/business-time轻松处理Carbon的工作时间和节假日

WBOY

发布： 2025-08-24 11:28:02

原创

997人浏览过

在日常开发中，经常遇到需要处理工作日和营业时间的需求。例如，计算一个任务的截止日期，需要排除周末和节假日；或者需要判断当前时间是否在营业时间内。这些看似简单的需求，如果手动实现，往往需要编写大量的代码，并且容易出错。

cmixin/business-time

登录后复制

是一个 carbon 的 mixin，它提供了一系列方便的方法来处理工作日、营业时间和节假日。通过使用

cmixin/business-time

登录后复制

，可以轻松地实现这些功能，大大简化了代码，提高了开发效率。

Composer在线学习地址：学习地址

实际问题

假设你需要开发一个在线预约系统，该系统需要：

只允许在工作日进行预约。
预约时间必须在营业时间内。
需要排除节假日。

如果没有

cmixin/business-time

登录后复制

，你需要编写大量的代码来判断日期是否是工作日，时间是否在营业时间内，以及是否是节假日。这不仅耗时，而且容易出错。

使用

cmixin/business-time

登录后复制

解决问题

安装
cmixin/business-time
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
：
```
<pre class="brush:php;toolbar:false;">composer require cmixin/business-time
```
登录后复制

启用

BusinessTime

登录后复制

mixin：

在应用的启动文件中（例如 Laravel 的

app/Providers/AppServiceProvider.php

登录后复制

）添加以下代码：

<pre class="brush:php;toolbar:false;"><?php

use Carbon\Carbon;
use Cmixin\BusinessTime;

BusinessTime::enable(Carbon::class, [
    'monday' => ['09:00-12:00', '13:00-18:00'],
    'tuesday' => ['09:00-12:00', '13:00-18:00'],
    'wednesday' => ['09:00-12:00'],
    'thursday' => ['09:00-12:00', '13:00-18:00'],
    'friday' => ['09:00-12:00', '13:00-20:00'],
    'saturday' => ['09:00-12:00', '13:00-16:00'],
    'sunday' => [],
    'exceptions' => [
        '2023-12-25' => [], // 圣诞节关闭
        '01-01' => [], // 元旦关闭
    ],
    'holidaysAreClosed' => true, // 默认节假日关闭
    'holidays' => [
        'region' => 'cn-national', // 使用中国国家节假日
    ],
]);

登录后复制

这段代码启用了

BusinessTime

登录后复制

mixin，并设置了默认的营业时间和节假日。

使用

BusinessTime

登录后复制

提供的方法：

<pre class="brush:php;toolbar:false;">use Carbon\Carbon;

$appointmentTime = Carbon::parse('2024-01-01 10:00');

if ($appointmentTime->isBusinessDay() && $appointmentTime->isOpen()) {
    echo "预约时间可用";
} else {
    echo "预约时间不可用";
}

登录后复制

这段代码使用