PHPackages                             konnco/filament-timematrix - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. konnco/filament-timematrix

ActiveLibrary[Utility & Helpers](/categories/utility)

konnco/filament-timematrix
==========================

A Filament form component for selecting time slots across days

v1.0.2(4mo ago)02.8k↓91.7%MITPHPPHP ^8.1|^8.2|^8.3|^8.4

Since Dec 31Pushed 4mo agoCompare

[ Source](https://github.com/konnco/filament-timematrix)[ Packagist](https://packagist.org/packages/konnco/filament-timematrix)[ Docs](https://github.com/konnco/filament-timematrix)[ RSS](/packages/konnco-filament-timematrix/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (5)Used By (0)

[![Screenshot of Login](./art/ilustration.jpg)](./art/ilustration.jpg)

Filament Time Matrix
====================

[](#filament-time-matrix)

An interactive Filament form component for selecting time slots across days with powerful validation and manipulation features.

Features
--------

[](#features)

- 📅 Interactive day/hour matrix with bulk selection
- ✅ Select all hours/days/slots at once
- 🔄 Reset functionality
- 🔢 Real-time slot counter
- 🛠️ Facade for validation & manipulation
- 🌍 Multi-language support via Carbon
- 🎨 Dark mode support

Requirements
------------

[](#requirements)

- **PHP**: 8.1 or higher
- **Filament**: 3.0 or higher
- **Laravel**: 10.0 or 11.0 or higher
- **Carbon**: 2.0 or 3.0 or higher

---

Installation
------------

[](#installation)

```
composer require konnco/filament-timematrix
```

Quick Start
-----------

[](#quick-start)

### Simple Usage

[](#simple-usage)

```
use Konnco\FilamentTimeMatrix\Forms\TimeMatrix;

TimeMatrix::make('schedule')
    ->label('Select Schedule')
    ->required();
```

This will create a time matrix with:

- All 7 days of the week (Monday - Sunday)
- All 24 hours (0-23)
- Select all hours/days buttons enabled
- Using your app's default locale

### Complete Usage

[](#complete-usage)

```
use Konnco\FilamentTimeMatrix\Forms\TimeMatrix;
use Konnco\FilamentTimeMatrix\Enums\Day;
use Carbon\CarbonInterface;

TimeMatrix::make('schedule')
    ->label('Select Schedule')
    ->required()
    ->helperText('Select operational hours for each day')

    # Set custom hour range (9 AM - 5 PM)
    ->hours(startTime: 9, endTime: 17)

    # OR use business hours shortcut with default range from 9 AM - 5 PM
    ->businessHours()

    # Set specific days using Day enum
    ->days([
        Day::MONDAY,
        Day::TUESDAY,
        Day::WEDNESDAY,
    ])
    # OR use Carbon constants
    ->days([
        CarbonInterface::MONDAY,
        CarbonInterface::SATURDAY,
    ])
    # OR use helper methods
    ->weekdays() # Monday - Friday only
    ->weekend()  # Saturday - Sunday only

    # Set locale and format
    ->locale('id', 'long')  # long: Monday, short: Mon,
    ->locale('en', 'short')

    # Toggle select all buttons
    ->showSelectAllHours(false)
    ->showSelectAllDays(false)

    ->columnSpanFull();
```

### Available Methods

[](#available-methods)

MethodDescriptionExample`hours(int $startTime, int $endTime)`Set custom hour range (0-23)`->hours(8, 18)``businessHours(int $startTime, int $endTime)`Shortcut for business hours`->businessHours(9, 17)``days(array $days)`Set specific days (Day enum or Carbon constants)`->days([Day::MONDAY, Day::FRIDAY])``weekdays()`Monday to Friday only`->weekdays()``weekend()`Saturday and Sunday only`->weekend()``locale(?string $locale, string $format)`Set locale and format (long/short/min)`->locale('id', 'short')``showSelectAllHours(bool $show)`Show/hide select all hours button`->showSelectAllHours(false)``showSelectAllDays(bool $show)`Show/hide select all days button`->showSelectAllDays(false)`---

Facade Methods Reference
------------------------

[](#facade-methods-reference)

#### `isActiveAt(array $data, ?Carbon $dateTime = null): bool`

[](#isactiveatarray-data-carbon-datetime--null-bool)

Check if time slot is active at a specific time or now (default).

**Parameters:**

- `$data` (array): The time matrix data
- `$dateTime` (Carbon|null, optional): DateTime to check. **Defaults to now()**

**Returns:** `bool`

**Examples:**

```
use Konnco\FilamentTimeMatrix\Facades\TimeMatrix;
use Carbon\Carbon;

$data = ['monday' => [8 => true, 9 => true]];

# Check if active right now
TimeMatrix::isActiveAt($data);

# Check if active at specific time
TimeMatrix::isActiveAt($data, Carbon::parse('next monday 8:00')); # true
TimeMatrix::isActiveAt($data, Carbon::tomorrow()->setTime(14, 0)); # true/false

# Check if active 2 hours from now
TimeMatrix::isActiveAt($data, now()->addHours(2));
```

---

#### `hasActiveDay(array $data, string|Day|null $day = null): bool`

[](#hasactivedayarray-data-stringdaynull-day--null-bool)

Check if there are active slots on a specific day or today (default).

**Parameters:**

- `$data` (array): The time matrix data
- `$day` (string|Day|null, optional): Day to check. **Defaults to today**

**Returns:** `bool`

**Examples:**

```
use Konnco\FilamentTimeMatrix\Enums\Day;
use Carbon\Carbon;

$data = [
    'monday' => [8 => true],
    'tuesday' => [14 => true],
];

# Check if active today (no parameter needed!)
TimeMatrix::hasActiveDay($data); # true/false

# Check specific days
TimeMatrix::hasActiveDay($data, Day::MONDAY);
TimeMatrix::hasActiveDay($data, 'tuesday');
TimeMatrix::hasActiveDay($data, Day::WEDNESDAY);

# Check tomorrow
TimeMatrix::hasActiveDay($data, Day::fromCarbon(Carbon::tomorrow()));
```

---

#### `getActiveHours(array $data, string|Day|null $day = null): array`

[](#getactivehoursarray-data-stringdaynull-day--null-array)

Get active hours for a specific day or today (default).

**Parameters:**

- `$data` (array): The time matrix data
- `$day` (string|Day|null, optional): Day to get hours from. **Defaults to today**

**Returns:** `array` - Array of hours like \[8, 9, 10, 14, 15\]

**Examples:**

```
use Konnco\FilamentTimeMatrix\Enums\Day;

$data = [
    'monday' => [8 => true, 9 => true, 14 => true],
    'tuesday' => [10 => true, 11 => true],
];

# Get today's active hours
TimeMatrix::getActiveHours($data); # [8, 9, 14]

# Get specific day's hours
TimeMatrix::getActiveHours($data, Day::MONDAY); # [8, 9, 14]
TimeMatrix::getActiveHours($data, 'tuesday'); # [10, 11]

# Get tomorrow's hours
TimeMatrix::getActiveHours($data, Day::fromCarbon(Carbon::tomorrow()));

# Loop through today's hours
foreach (TimeMatrix::getActiveHours($data) as $hour) {
    echo sprintf('%02d:00 - Available', $hour);
}
```

---

### Validation Methods

[](#validation-methods)

#### `validate(array $data): bool`

[](#validatearray-data-bool)

Validate the structure of time matrix data.

**Example:**

```
$valid = ['monday' => [8 => true, 9 => false]];
TimeMatrix::validate($valid); # true

$invalid = ['monday' => 'not an array'];
TimeMatrix::validate($invalid); # false
```

---

#### `hasSelection(array $data): bool`

[](#hasselectionarray-data-bool)

Check if there is at least one selected slot.

**Example:**

```
$data = ['monday' => [8 => true, 9 => false]];
TimeMatrix::hasSelection($data); # true

$empty = ['monday' => [8 => false]];
TimeMatrix::hasSelection($empty); # false
```

---

### Statistics Methods

[](#statistics-methods)

#### `isFullyActive(array $data): bool`

[](#isfullyactivearray-data-bool)

Check if schedule is 24/7 (all days, all hours).

**Example:**

```
TimeMatrix::isFullyActive($data); # true/false
```

---

#### `getTotalActiveHours(array $data): int`

[](#gettotalactivehoursarray-data-int)

Get total active hours per week.

**Example:**

```
$total = TimeMatrix::getTotalActiveHours($data); # e.g., 40
```

---

#### `getActivePercentage(array $data): float`

[](#getactivepercentagearray-data-float)

Get percentage of active hours (0-100).

**Example:**

```
$percentage = TimeMatrix::getActivePercentage($data); # e.g., 23.81
```

---

#### `getActiveDays(array $data): array`

[](#getactivedaysarray-data-array)

Get days that have at least one active hour.

**Returns:** Array of `Day` enums

**Example:**

```
$days = TimeMatrix::getActiveDays($data);
# [Day::MONDAY, Day::TUESDAY, Day::FRIDAY]

foreach ($days as $day) {
    echo $day->label(); # Monday, Tuesday, Friday
}
```

---

#### `isDayHourActive(array $data, string|Day $day, int $hour): bool`

[](#isdayhouractivearray-data-stringday-day-int-hour-bool)

Check if a specific day and hour combination is active.

**Example:**

```
TimeMatrix::isDayHourActive($data, day: Day::MONDAY, hour: 9); # true/false
TimeMatrix::isDayHourActive($data, day: 'friday', hour: 18); # true/false
```

---

### Time Query Methods

[](#time-query-methods)

#### `getNextAvailableSlot(array $data, Carbon $from): ?Carbon`

[](#getnextavailableslotarray-data-carbon-from-carbon)

Get next available slot from a specific time.

**Example:**

```
$next = TimeMatrix::getNextAvailableSlot($data, now());
if ($next) {
    echo $next->format('l, H:i'); # "Monday, 08:00"
}
```

---

#### `getSlotsInRange(array $data, Carbon $start, Carbon $end): array`

[](#getslotsinrangearray-data-carbon-start-carbon-end-array)

Get all slots within a date range.

**Example:**

```
$slots = TimeMatrix::getSlotsInRange(
    $data,
    now()->startOfWeek(),
    now()->endOfWeek()
);

foreach ($slots as $slot) {
    echo $slot->format('D H:i') . "\n";
}
```

---

#### `toCarbonSlots(array $data, ?Carbon $referenceWeek = null): array`

[](#tocarbonslotsarray-data-carbon-referenceweek--null-array)

Convert to Carbon instances for a specific week.

**Example:**

```
# Current week
$slots = TimeMatrix::toCarbonSlots($data);

# Next week
$nextWeek = now()->addWeek();
$slots = TimeMatrix::toCarbonSlots($data, $nextWeek);
```

---

### Formatting Methods

[](#formatting-methods)

#### `toReadableFormat(array $data): array`

[](#toreadableformatarray-data-array)

Convert to simplified format.

**Returns:** `['monday' => [8, 9, 10], 'tuesday' => [14, 15]]`

**Example:**

```
$readable = TimeMatrix::toReadableFormat($data);
```

---

#### `formatDaySchedule(array $data, string|Day $day): string`

[](#formatdayschedulearray-data-stringday-day-string)

Format single day to human-readable string.

**Returns:** String like "08:00-10:59, 14:00-16:59"

**Example:**

```
$schedule = TimeMatrix::formatDaySchedule($data, Day::MONDAY);
# "08:00-10:59, 14:00-16:59"
```

---

#### `formatAllDays(array $data, ?string $locale = null): array`

[](#formatalldaysarray-data-string-locale--null-array)

Format all days with localized labels.

**Example:**

```
$formatted = TimeMatrix::formatAllDays($data, 'en');
# [
#     'Monday' => '08:00-10:59, 14:00-16:59',
#     'Tuesday' => '14:00-15:59'
# ]

$formatted = TimeMatrix::formatAllDays($data, 'id');
# [
#     'Senin' => '08:00-10:59, 14:00-16:59',
#     'Selasa' => '14:00-15:59'
# ]
```

---

Real-World Usage Examples
-------------------------

[](#real-world-usage-examples)

### 1. Check Merchant Status

[](#1-check-merchant-status)

```
use Konnco\FilamentTimeMatrix\Facades\TimeMatrix;

class StoreService
{
    public function getOpenStores()
    {
        return Store::all()->filter(function ($store$) {
            # No parameter = check now!
            return TimeMatrix::isActiveAt($store$->operational_hours);
        });
    }

    public function countOpenNow(): int
    {
        return Store::get()->filter(fn($store) =>
            TimeMatrix::isActiveAt($store->operational_hours)
        )->count();
    }

    public function getOpenTomorrow()
    {
        return Store::get()->filter(fn($store) =>
            TimeMatrix::hasActiveDay(
                $store->operational_hours,
                Day::fromCarbon(Carbon::tomorrow())
            )
        );
    }
}
```

---

### 2. Display in Infolist

[](#2-display-in-infolist)

```
use Filament\Infolists\Components\TextEntry;

TextEntry::make('schedule')
    ->label('Status Now')
    ->state(fn($record) => TimeMatrix::isActiveAt($record->schedule)
        ? '✓ Open'
        : '✗ Closed'
    )
    ->badge()
    ->color(fn($record) => TimeMatrix::isActiveAt($record->schedule)
        ? 'success'
        : 'danger'
    ),

TextEntry::make('schedule')
    ->label('Today\'s Hours')
    ->state(function ($record) {
        $hours = TimeMatrix::getActiveHours($record->schedule); # Today by default!
        return empty($hours)
            ? 'Closed today'
            : implode(', ', array_map(fn($h) => sprintf('%02d:00', $h), $hours));
    }),
```

---

API Methods Summary
-------------------

[](#api-methods-summary)

### Smart Default Methods (NEW!)

[](#smart-default-methods-new)

MethodDefault BehaviorUsage`isActiveAt($data, ?$dateTime)`Checks **now** if no param`isActiveAt($data)``hasActiveDay($data, ?$day)`Checks **today** if no param`hasActiveDay($data)``getActiveHours($data, ?$day)`Gets **today's** hours if no param`getActiveHours($data)`### All Available Methods

[](#all-available-methods)

MethodReturn TypeDescription`validate($data)``bool`Validate structure`hasSelection($data)``bool`Check if has selections`isActiveAt($data, ?$dateTime)``bool`Check active at time (default: now)`hasActiveDay($data, ?$day)``bool`Check day has active slots (default: today)`getActiveHours($data, ?$day)``array`Get active hours (default: today)`isFullyActive($data)``bool`Check if 24/7`getTotalActiveHours($data)``int`Total hours per week`getActivePercentage($data)``float`Coverage percentage`getActiveDays($data)``array`Days with active slots`isDayHourActive($data, $day, $hour)``bool`Check specific day+hour`getNextAvailableSlot($data, $from)``?Carbon`Next available slot`getSlotsInRange($data, $start, $end)``array`Slots in range`toCarbonSlots($data, ?$week)``array`Convert to Carbon`formatDaySchedule($data, $day)``string`Format single day`formatAllDays($data, ?$locale)``array`Format all days`toReadableFormat($data)``array`Simplified format---

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

Credits
-------

[](#credits)

- [Konnco Studio](https://github.com/konnco)
- [All Contributors](../../contributors)

Support
-------

[](#support)

For issues and feature requests, please use the [GitHub issue tracker](https://github.com/konnco/filament-timematrix/issues).

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance77

Regular maintenance activity

Popularity23

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

3

Last Release

126d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2cc4521e9641c59a269f7ec3a670d781681e7d7be8e57be66dafd95d15304693?d=identicon)[frankyso.pg](/maintainers/frankyso.pg)

![](https://www.gravatar.com/avatar/9d74e0b1648043451a5e3978416bb76a95666fa89f8c957388102ff0c19ca3e8?d=identicon)[gabrieladvent](/maintainers/gabrieladvent)

![](https://www.gravatar.com/avatar/67837b4df83a1833fdb5e5458511957b375957c66f3bf26bbcf5a6e655fa0478?d=identicon)[revelation017](/maintainers/revelation017)

---

Top Contributors

[![gabrieladvent](https://avatars.githubusercontent.com/u/111355871?v=4)](https://github.com/gabrieladvent "gabrieladvent (8 commits)")

---

Tags

laravelschedulefilamentform-componenttime-matrix

### Embed Badge

![Health badge](/badges/konnco-filament-timematrix/health.svg)

```
[![Health](https://phpackages.com/badges/konnco-filament-timematrix/health.svg)](https://phpackages.com/packages/konnco-filament-timematrix)
```

###  Alternatives

[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

58289.3k3](/packages/creagia-filament-code-field)[swisnl/filament-backgrounds

Beautiful backgrounds for Filament auth pages

54149.2k6](/packages/swisnl-filament-backgrounds)[tapp/filament-google-autocomplete-field

Filament plugin that provides a Google Autocomplete field

3098.1k](/packages/tapp-filament-google-autocomplete-field)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)