Rails engine that sets the Rails timezone to the browser time zone for each request.
Switch branches/tags
Nothing to show
Clone or download
kbaum Merge pull request #41 from KoanHealth/feature/secure-cookie
When using force_ssl in the application, mark the cookie as secure
Latest commit 55c366f Nov 14, 2018



Build Status Code Quality

Rails Engine which sets the Rails timezone to the browser's configured timezone for each request.


Add it to your Gemfile.

gem 'browser-timezone-rails'

Make sure you have each of the following entries in your application.js:

//= require js.cookie
//= require jstz
//= require browser_timezone_rails/set_time_zone

That's it! No other configuration is needed as it's all done for you with this gem including setting up your application controller to start using your users' zones.

How it works

The browsers timezone is set in a cookie using the awesome jsTimezoneDetect javascript library. That cookie is then read during each request to set the Rails timezone for that user.

You can also read more about this implementation here: Blog

For those of you who need or want to do this on the backend with just Rails, Ryan Bates has a good RailsCast on how to that: RailsCast #106

About that cookie

The cookie is set each full page request and lives for 365 days

Thread safety

Yes. It uses the Rails Time.zone method which is thread safe.


The first request ever made by a user's browser to your app will not set the browser's time zone as the javascript that sets the cookie has not yet run on their browser. This will only happen once and for me it was not a problem.


To run the tests, invoke bundle exec rspec.