Emojizones

Emojizones helps you convert one datetime in one time zone to another, using the emojiis you are used to from your iPhone. Never have time zone conversion been this easy!

Installation

pip install emojizones

Getting started

from emojizones import convert
from datetime import datetime

# Here we have a naive datetime without a time zone
from_time = datetime(2020, 3, 7, 0, 0, 0)

# Now we use the emojizones.convert-method
to_time = convert(
    from_time,
    "🗻",  # Mount Fuji, Japan --> Asia/Tokyo
    "🗽"   # Statue of Libery, New York --> America/New_York
)
print(to_time)
# 2020-03-06 10:00:00

Note how time has shifted 14 hours back, corresponding to the difference between Japan (UTC+9) and New York (UTC-5).

Couldn't be simpler!

Technical notes

1. Country flags make this project quite usable, all countries are represented!

   convert(
       "2020-03-07 00:00:00",
       "🇸🇪",  # Sweden --> Europe/Stockholm
       "🇫🇮"   # Finland --> Europe/Helsinki
   )
   # 2020-03-07 01:00:00
   

2. Some contries have multiple time zones, but no emoji to represent them. Luckily, you can use emoji aritmetics to append a UTC offset to your time zone!

   convert(
       "2020-03-07 00:00:00",
       "🗽",      # Statue of Libery, New York --> America/New_York
       "🗽➕4️⃣"   # America/New_York + 4 --> 'America/Scoresbysund'
   )
   # 2020-03-07 04:00:00
   

   You can even do emoji aritmetic with complex statments... Here's somthing that evaluates to Europe/Paris + 5 hours.

   convert(
       "2020-03-07 00:00:00", 
       "🥖", 
       "🥖➕4️⃣✖3️⃣➗2️⃣➖1️⃣"
   )
   # 2020-03-07 05:00:00
   

3. To lookup what timezone a specific emoji corresponds to, use the emoji_lookup method.

   from emojizones import emoji_lookup
   
   emoji_lookup("🥖")  # --> "Europe/Paris"
   emoji_lookup("🥖➕2️⃣", from_dt="2020-03-07 00:00:00")  # --> "Europe/Istanbul"
   

4. This means you can use this as a calculator if you want! Let's say you want to calculate 4 * 3.

   from_time = datetime(2000, 1, 1, 0, 0)
   timezone = emoji_lookup("👨‍🎤➕4️⃣✖3️⃣-👨‍🎤", from_time)
   difference = pytz.timezone(timezone).utcoffset(from_time.replace(tzinfo=None))
   hours = difference.total_seconds() / (60 * 60)
   hours
   # 12
   

Supported emojis

People

Nature

Food Drink

Activites

Places

Objects

Symbols

Flags

Hard Flags