django-easy-timezones-redux

django-easy-timezones-redux

Easy IP-based timezones for Django (>=1.11) based on MaxMind GeoIP, with IPv6 support. Updated fork of django-easy-timezones that uses the new version of MaxMind's GeoIP2 database.

Quick start

1. Install django-easy-timezones-redux

   pip install django-easy-timezones-redux
   

2. Add "easy-timezones" to your INSTALLED_APPS setting like this:

   INSTALLED_APPS = (
     ...
     'easy_timezones',
   )
   

3. Add EasyTimezoneMiddleware to your MIDDLEWARE

   MIDDLEWARE = (
     ...
     'easy_timezones.middleware.EasyTimezoneMiddleware',
   )
   

4. Add a path to the MaxMind GeoLite2 cities databases in your settings file:

   GEOIP2_DATABASE = '/path/to/your/geoip/database/GeoLite2-City.mmdb'
   

5. Enable localtime in your templates.

   {% load tz %}
       The UTC time is {{ object.date }}
   {% localtime on %}
       The local time is {{ object.date }}
   {% endlocaltime %}
   

6. That's it!

Signals

You can also use signals to perform actions based on the timezone detection.

1. To hook into the Timezone detection event to, say, save it to the request's user somewhere more permanent than a session, do something like this:

   from easy_timezones.signals import detected_timezone	
   
   @receiver(detected_timezone, sender=MyUserModel)
   def process_timezone(sender, instance, timezone, **kwargs):
   	if instance.timezone != timezone:
       	instance.timezone = timezone
       	instance.save()