Skip to content
Enable user Timezones in your application.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitattributes
.gitignore Removing redundant composer.lock file Jul 31, 2018
.php_cs
Makefile
README.md
composer.json Updating dependancies to be fixed to none breaking changes Jul 31, 2018

README.md

Laravel Timezone

Packagist Packagist

An easy way to set a timezone for a user in your application and then show date/times to them in their local timezone.

All you have to do is install this package, run the migration and go!

How

This package listens for the \Illuminate\Auth\Events\Login event and will then automatically set a timezone on your user model (stored in the database).

You can show dates to your user in their timezone by using {{ Timezone::convertToLocal($post->created_at) }}.

Installation

Pull in the package using Composer

composer require jamesmills/laravel-timezone

Run the database migrations. This will add a timezone column to your users table.

php artisan migrate

Flash Messages

By default when the timezone has been set there is a flash message set in the session. There is an optional integration to use laracasts/flash package if you wish. Just publish the config options (info below) and override the default settings.

Custom Configuration

There isn't much to configure right now. You only need to do this if you want to use Laracast Flash Messages

php artisan vendor:publish --provider="JamesMills\LaravelTimezone\LaravelTimezoneServiceProvider" --tag="config"

Examples

Showing date/time to the user in their timezone

Default will use the format jS F Y g:i:a and will not show the timezone

{{ Timezone::convertToLocal($post->created_at) }}

4th July 2018 3:32:am

If you wish you can set a custom format and also include a nice version of the timezone

{{ Timezone::convertToLocal($post->created_at, 'Y-m-d g:i', true) }}

2018-07-04 3:32 New York, America

Using blade directive

Making your life easier one small step at a time

@displayDate($post->created_at)

4th July 2018 3:32:am

And with custom formatting

@displayDate($post->created_at, 'Y-m-d g:i', true)

2018-07-04 3:32 New York, America

Saving the users input to the database in UTC

This will take a date/time, set it to the users timezone then return it as UTC in a Carbon instance.

$post = Post::create([
    'publish_at' => Timezone::convertFromLocal($request->get('publish_at')),
    'description' => $request->input('description'),
]);
You can’t perform that action at this time.