README

📅 A custom DateTime field for Laravel Nova 4 with localization support.
This package extends VueDatePicker to provide a flexible and user-friendly date selection experience.

TODO:Test in Nova 5

📌 Installation

Step 1: Add the package to your Laravel Nova project:

composer require sinensia/localizeddatetime

Step 2: Install Dependencies

Before installing the package, ensure your system has the required PHP extensions bcmath and zip.

1️⃣ Install Required PHP Extensions

For Ubuntu/Debian users, run:

sudo apt update
sudo apt install php-bcmath php-zip -y

2️⃣ Verify That Extensions Are Enabled

Check if the extensions are active (for example, in Apache):

php -m | grep -E "bcmath|zip"

If any extension is missing, you may need to restart PHP:

sudo systemctl restart apache2  # For Apache users
sudo systemctl restart php-fpm  # For Nginx with PHP-FPM

🛠️ Usage

In your Nova Resource:

use Sinensia\Localizeddatetime\LocalizeddateTime;

public function fields(NovaRequest $request)
{
    return [
        Localizeddatetime::make('Fecha Inicio')
            ->withMeta([
                'locale' => auth()->user()->locale, // You can use the authenticated user locale
                'firstDayOfWeek' => 1,  // Monday
                'dateFormat' => 'dd/MM/yyyy HH:mm',
                'enableTimePicker' => true,
                'range' => true, // Allow a date range setup
                'showShortValue' => false, // Index field can show short format i.e. 11/02 or full 11/02/2025 14:00
                'presetRanges' => [
                    ['label' => 'Hoy', 'range' => [now(), now()]],
                    ['label' => 'Este mes', 'range' => [now()->startOfMonth(), now()->endOfMonth()]],
                    ['label' => 'El mes pasado', 'range' => [now()->subMonth()->startOfMonth(), now()->subMonth()->endOfMonth()]],
                    ['label' => 'Este trimestre', 'range' => [now()->startOfQuarter(), now()->endOfQuarter()]],
                    ['label' => 'Este año', 'range' => [now()->startOfYear(), now()->endOfYear()], 'slot' => 'yearly'],
                ],
            ])
            ->rules('required', 'date'),
    ];
}

🔧 Available Meta Options

Option	Description
`locale`	User's preferred locale (`ca`, `es`, `en`)
`firstDayOfWeek`	First day of the week (1 = Monday, 0 = Sunday)
`dateFormat`	Example: `dd/MM/yyyy HH:mm`
`enableTimePicker`	`true`: Enables time selection, `false`: Date only
`range`	`true`: Allows date range selection, `false`: Single date
`showShortValue`	`true`: Shows only day/month, `false`: Shows full date
`presetRanges`	Predefined date ranges for quick selection

🏗️ Compatibility

✅ Laravel Nova 4+
✅ Vue 3
✅ VueDatePicker 3.x
✅ Date-FNS for localization

📜 Credits

Developed by Sinensia
GitHub Repository

📄 License

This package is open-source and released under the MIT License.

sinensia / localizeddatetime

Maintainers

Details