Date Fields

Nova offers two types of date fields: Date and DateTime. As you may have guessed, the Date field does not store time information while the DateTime field does:

use Laravel\Nova\Fields\Date;
use Laravel\Nova\Fields\DateTime;

// ...

Date::make('Birthday'),
DateTime::make('Created At'),

​

Options

​

Steps

By default, Nova will set a minimum “step” of 1 day for Date fields and 1 second for DateTime fields. You may modify the “step” value for both of these fields by providing an integer or Carbon\CarbonInterval to the field’s step methods:

use Carbon\CarbonInterval;
use Laravel\Nova\Fields\Date;
use Laravel\Nova\Fields\DateTime;

// ...

Date::make('Expired On')->step(7),
Date::make('Expired On')->step(CarbonInterval::weeks(1)),

DateTime::make('Published At')->step(60),
DateTime::make('Published At')->step(CarbonInterval::minutes(1)),

​

Minimum and Maximum Values

Sometimes you may wish to explicitly define minimum and maximum values for Date or DateTime fields. This can be done by passing a valid date expression, a date format supported by strtotime, or an instance of Carbon\CarbonInterface to the min and max methods of these fields:

use Carbon\Carbon;
use Laravel\Nova\Fields\Date;

// ...

Date::make('Expired On')
    ->min('tomorrow')
    ->max('next week'),

Date::make('Expired On')
    ->min(Carbon::tomorrow())
    ->max(Carbon::today()->addWeek(1)),

​

Timezones

By default, Nova users will always see dates presented in your application’s “server-side” timezone as defined by the timezone configuration option in your application’s config/app.php configuration file.

​

Customizing the Timezone

Sometimes you may wish to explicitly define the Nova user’s timezone instead of using the application’s timezone configuration. For example, perhaps your application allows users to select their own timezone so that they always see consistent date timezones even when traveling around the world.

To accomplish this, you may use the Nova::userTimezone method. Typically you should call this method in the boot method of your application’s NovaServiceProvider:

use Laravel\Nova\Nova;
use Illuminate\Http\Request;

// ... 

/**
 * Bootstrap any application services.
 */
public function boot(): void
{
    parent::boot();

    Nova::userTimezone(function (Request $request) {
        return $request->user()?->timezone;
    });
}