Socket
Socket
Sign inDemoInstall

emojizones

Package Overview
Dependencies
2
Maintainers
1
Alerts
File Explorer

Install Socket

Detect and block malicious and high-risk dependencies

Install

    emojizones

A helper library to convert dates between timezone using emojiis


Maintainers
1

Readme

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

EmojiTimezoneComment
💂Europe/LondonBritish guard
💂‍♂️Europe/LondonBritish guard, male
💂‍♀️Europe/LondonBritish guard, female
👨‍🎤Europe/LondonDavid Bowie, born in London, male
👩‍🎤Europe/LondonDavid Bowie, born in London, female
🧛Europe/BucharestDracula, Transylvania, Romania
🧛‍♂️Europe/BucharestDracula, Transylvania, Romania, male
🧛‍♀️Europe/BucharestDracula, Transylvania, Romania, female
👘Asia/TokyoA traditional Japanese robe that can be worn by women or men
👑Europe/LondonThe Queen, Longond, Great Britain

Nature

EmojiTimezoneComment
🐲Asia/ShanghaiChinese dragon
🐉Asia/ShanghaiChinese dragon
🌍Africa/KinshasaMap centered on Africa, which has DNC as the centre
🌎America/GuayaquilMap centered on South America with Ecuador in the middle
🌏Asia/JakartaMap centered on Jakarta, Indonesia
🌧️Africa/ConakryConakry, Guinea is the place with the most rain worldwide
🎋Asia/TokyoA Tanabata tree, a type of wish tree from the Japanese festival
🎍Asia/TokyoA Japanese kadomatsu, traditionally placed outside homes in Japan around the New Year

Food Drink

EmojiTimezoneComment
🍊Africa/CasablancaOrange-colored citrus fruit, originally from Tangier, Morocco
🥐Europe/ParisCroissant, France
🥖Europe/ParisBaguette, France
🥨Europe/BerlinPretzel, Germany
🥯Europe/WarsawA bagel is a bread product originating in the Jewish communities of Poland
🍟Europe/ParisFRENCH fries
🌮America/Mexico_CityA Mexican or Tex-Mex taco on a hard or soft corn tortilla
🌯America/Mexico_CityA Mexican or Tex-Mex burrito, featuring a wrapped flour tortilla
🥙Asia/BaghdadKebab, In 10th-century Baghdadi cookbook Kitab al-Tabikh, there are descriptions of kabāb
🍱Asia/TokyoJapanese Bento box
🍘Asia/TokyoA Japanese senbei, or rice cracker, wrapped with a sheet of nori
🍙Asia/TokyoA Japanese onigiri, a cone-shaped ball of white rice, a snack wrapped with a sheet of nori
🍝Europe/RomeA plate of Italian spaghetti with tomato sauce, as a bolognese
🍢Asia/TokyoA skewer of three bites of Japanese oden, a winter dish made with fishcakes
🍣Asia/TokyoJapanese sushi, generally depicted as two pieces of raw pinkish-orange fish
🍥Asia/TokyoA slice of Japanese narutomaki, a ridged fishcake of processed whitefish with an pink swirl
🥮Asia/ShanghaiGolden-brown pastry of a Chinese mooncake, traditional delicacy of the Mid-Autumn Festival
🍡Asia/TokyoA Japanese sweet dumpling made from rice flour and served on a skewer.
🥠Asia/ShanghaiChinese fortune cookie
🍵Asia/TokyoA cup of green tea, as the minty-colored Japanese matcha
🍶Asia/TokyoJapanese sake, an alcoholic beverage made from rice
🍾Europe/ParisCampagne, France
🥃Europe/LondonScotch, Great Britain

Activites

EmojiTimezoneComment
🏈America/New_YorkAmerican football, originating from Princeton University, New York
🏉Europe/LondonRugby, is a contact team sport that originated in England
🏏Europe/LondonCricket's rules are held in a code called the Laws of Cricket in London

Places

EmojiTimezoneComment
🗾Asia/TokyoMap of Japan
🗻Asia/TokyoMount Fuji
🏣Asia/TokyoJapanese Hospital
🏯Asia/TokyoJapanese Castle
🗼Asia/TokyoTokyo Tower
🗽America/New_YorkStatue of Liberty
🏛️Europe/AthensClassical building
🕋Asia/RiyadhKaaba, A cube-shaped building located at the centre of the Mosque in Mecca
🌉America/Los_AngelesGolden Gate Bridge, San Fransisco
🛸America/Los_AngelesArea 51, US Air fource facility, Nevada
💴Asia/TokyoYen bank note, Japan
💵America/New_YorkDollar bank note, Fort Knox, is a fortified vault building in Kentucky
💶Europe/BerlinEuro bank note, European Central bank, Berlin, Germany
💷Europe/LondonPound bank note, Great Britain
🗿Pacific/EasterMoai, monolithic human figures carved by the Rapa Nui people on Easter Island
🎑Asia/TokyoMoon Viewing Ceremony, Japan

Objects

EmojiTimezoneComment
🏺Europe/AthensAmphora, as used by ancient Greeks and Romans to hold water and wine.
🗺️Africa/AccraMap centered on Accra, Ghana
🎎Asia/TokyoOrnamental Japanese Emperor and Empress dolls
🎏Asia/TokyoJapanese koinobori, decorative, carp-shaped windsocks
🎐Asia/TokyoA Japanese wind chime
🧧Asia/ShanghaiA red envelope, as gifted with money on Chinese New Year
🧿Europe/IstanbulNazar Amulet, commonly used to represent Turkey and Turkish culture
💸America/New_YorkMoney with Wings, Fort Knox, is a fortified vault building in Kentucky

Symbols

EmojiTimezoneComment
💮Asia/TokyoWhite Flower with japanese characters roughly translating to very well done
♨️Asia/TokyoHot springs, common symbol used to represent an onsen on maps in Japan
🀄Asia/TokyoMahjong Red Dragon, the red dragon tile in the game of Japanese Mahjong
🎴Asia/TokyoFlower Playing Cards, a type of cards known as hanafuda cards in Japan
☢️Europe/KievChernobyl Nuclear Power Plant, near the city of Pripyat in the north of the Ukrainian
✡️Asia/JerusalemStar of David is a generally recognized symbol of modern Jewish identity and Judaism
🈁Asia/TokyoJapanese “Here” Button
🈂Asia/TokyoJapanese “Service Charge” Button
🈷Asia/TokyoJapanese “Monthly Amount” Button
🈶Asia/TokyoJapanese “Not Free of Charge” Button
🈯Asia/TokyoJapanese “Reserved” Button
🉐Asia/TokyoJapanese “Bargain” Button
🈹Asia/TokyoJapanese “Discount” Button
🈚Asia/TokyoJapanese “Free of Charge” Button
🈲Asia/TokyoJapanese “Prohibited” Button
🉑Asia/TokyoJapanese “Acceptable” Button
🈸Asia/TokyoJapanese “Application” Button
🈴Asia/TokyoJapanese “Passing Grade” Button
🈳Asia/TokyoJapanese “Vacancy” Button
Asia/TokyoJapanese “Congratulations” Button
Asia/TokyoJapanese “Secret” Button
🈺Asia/TokyoJapanese “Open for Business” Button
🈵Asia/TokyoJapanese “No Vacancy” Button

Flags

EmojiTimezoneComment
🎌Asia/TokyoTwo Japanese Flags
🇦🇩Europe/AndorraAD
🇦🇪Asia/DubaiAE
🇦🇫Asia/KabulAF
🇦🇬America/AntiguaAG
🇦🇮America/AnguillaAI
🇦🇱Europe/TiraneAL
🇦🇲Asia/YerevanAM
🇦🇴Africa/LuandaAO
🇦🇶Antarctica/VostokAQ
🇦🇷America/Argentina/UshuaiaAR
🇦🇸Pacific/Pago_PagoAS
🇦🇹Europe/ViennaAT
🇦🇺Australia/SydneyAU
🇦🇼America/ArubaAW
🇦🇽Europe/MariehamnAX
🇦🇿Asia/BakuAZ
🇧🇦Europe/SarajevoBA
🇧🇧America/BarbadosBB
🇧🇩Asia/DhakaBD
🇧🇪Europe/BrusselsBE
🇧🇫Africa/OuagadougouBF
🇧🇬Europe/SofiaBG
🇧🇭Asia/BahrainBH
🇧🇮Africa/BujumburaBI
🇧🇯Africa/Porto-NovoBJ
🇧🇱America/St_BarthelemyBL
🇧🇲Atlantic/BermudaBM
🇧🇳Asia/BruneiBN
🇧🇴America/La_PazBO
🇧🇶America/KralendijkBQ
🇧🇷America/Sao_PauloBR
🇧🇸America/NassauBS
🇧🇹Asia/ThimphuBT
🇧🇼Africa/GaboroneBW
🇧🇾Europe/MinskBY
🇧🇿America/BelizeBZ
🇨🇦America/YellowknifeCA
🇨🇨Indian/CocosCC
🇨🇩Africa/LubumbashiCD
🇨🇫Africa/BanguiCF
🇨🇬Africa/BrazzavilleCG
🇨🇭Europe/ZurichCH
🇨🇮Africa/AbidjanCI
🇨🇰Pacific/RarotongaCK
🇨🇱Pacific/EasterCL
🇨🇲Africa/DoualaCM
🇨🇳Asia/UrumqiCN
🇨🇴America/BogotaCO
🇨🇷America/Costa_RicaCR
🇨🇺America/HavanaCU
🇨🇻Atlantic/Cape_VerdeCV
🇨🇼America/CuracaoCW
🇨🇽Indian/ChristmasCX
🇨🇾Asia/NicosiaCY
🇨🇿Europe/PragueCZ
🇩🇪Europe/BusingenDE
🇩🇯Africa/DjiboutiDJ
🇩🇰Europe/CopenhagenDK
🇩🇲America/DominicaDM
🇩🇴America/Santo_DomingoDO
🇩🇿Africa/AlgiersDZ
🇪🇨Pacific/GalapagosEC
🇪🇪Europe/TallinnEE
🇪🇬Africa/CairoEG
🇪🇭Africa/El_AaiunEH
🇪🇷Africa/AsmaraER
🇪🇸Europe/MadridES
🇪🇹Africa/Addis_AbabaET
🇫🇮Europe/HelsinkiFI
🇫🇯Pacific/FijiFJ
🇫🇰Atlantic/StanleyFK
🇫🇲Pacific/PohnpeiFM
🇫🇴Atlantic/FaroeFO
🇫🇷Europe/ParisFR
🇬🇦Africa/LibrevilleGA
🇬🇧Europe/LondonGB
🇬🇩America/GrenadaGD
🇬🇪Asia/TbilisiGE
🇬🇫America/CayenneGF
🇬🇬Europe/GuernseyGG
🇬🇭Africa/AccraGH
🇬🇮Europe/GibraltarGI
🇬🇱America/ThuleGL
🇬🇲Africa/BanjulGM
🇬🇳Africa/ConakryGN
🇬🇵America/GuadeloupeGP
🇬🇶Africa/MalaboGQ
🇬🇷Europe/AthensGR
🇬🇸Atlantic/South_GeorgiaGS
🇬🇹America/GuatemalaGT
🇬🇺Pacific/GuamGU
🇬🇼Africa/BissauGW
🇬🇾America/GuyanaGY
🇭🇰Asia/Hong_KongHK
🇭🇳America/TegucigalpaHN
🇭🇷Europe/ZagrebHR
🇭🇹America/Port-au-PrinceHT
🇭🇺Europe/BudapestHU
🇮🇩Asia/PontianakID
🇮🇪Europe/DublinIE
🇮🇱Asia/JerusalemIL
🇮🇲Europe/Isle_of_ManIM
🇮🇳Asia/KolkataIN
🇮🇴Indian/ChagosIO
🇮🇶Asia/BaghdadIQ
🇮🇷Asia/TehranIR
🇮🇸Atlantic/ReykjavikIS
🇮🇹Europe/RomeIT
🇯🇪Europe/JerseyJE
🇯🇲America/JamaicaJM
🇯🇴Asia/AmmanJO
🇯🇵Asia/TokyoJP
🇰🇪Africa/NairobiKE
🇰🇬Asia/BishkekKG
🇰🇭Asia/Phnom_PenhKH
🇰🇮Pacific/TarawaKI
🇰🇲Indian/ComoroKM
🇰🇳America/St_KittsKN
🇰🇵Asia/PyongyangKP
🇰🇷Asia/SeoulKR
🇰🇼Asia/KuwaitKW
🇰🇾America/CaymanKY
🇰🇿Asia/QyzylordaKZ
🇱🇦Asia/VientianeLA
🇱🇧Asia/BeirutLB
🇱🇨America/St_LuciaLC
🇱🇮Europe/VaduzLI
🇱🇰Asia/ColomboLK
🇱🇷Africa/MonroviaLR
🇱🇸Africa/MaseruLS
🇱🇹Europe/VilniusLT
🇱🇺Europe/LuxembourgLU
🇱🇻Europe/RigaLV
🇱🇾Africa/TripoliLY
🇲🇦Africa/CasablancaMA
🇲🇨Europe/MonacoMC
🇲🇩Europe/ChisinauMD
🇲🇪Europe/PodgoricaME
🇲🇫America/MarigotMF
🇲🇬Indian/AntananarivoMG
🇲🇭Pacific/MajuroMH
🇲🇰Europe/SkopjeMK
🇲🇱Africa/BamakoML
🇲🇲Asia/YangonMM
🇲🇳Asia/UlaanbaatarMN
🇲🇴Asia/MacauMO
🇲🇵Pacific/SaipanMP
🇲🇶America/MartiniqueMQ
🇲🇷Africa/NouakchottMR
🇲🇸America/MontserratMS
🇲🇹Europe/MaltaMT
🇲🇺Indian/MauritiusMU
🇲🇻Indian/MaldivesMV
🇲🇼Africa/BlantyreMW
🇲🇽America/TijuanaMX
🇲🇾Asia/KuchingMY
🇲🇿Africa/MaputoMZ
🇳🇦Africa/WindhoekNA
🇳🇨Pacific/NoumeaNC
🇳🇪Africa/NiameyNE
🇳🇫Pacific/NorfolkNF
🇳🇬Africa/LagosNG
🇳🇮America/ManaguaNI
🇳🇱Europe/AmsterdamNL
🇳🇴Europe/OsloNO
🇳🇵Asia/KathmanduNP
🇳🇷Pacific/NauruNR
🇳🇺Pacific/NiueNU
🇳🇿Pacific/ChathamNZ
🇴🇲Asia/MuscatOM
🇵🇦America/PanamaPA
🇵🇪America/LimaPE
🇵🇫Pacific/TahitiPF
🇵🇬Pacific/Port_MoresbyPG
🇵🇭Asia/ManilaPH
🇵🇰Asia/KarachiPK
🇵🇱Europe/WarsawPL
🇵🇲America/MiquelonPM
🇵🇳Pacific/PitcairnPN
🇵🇷America/Puerto_RicoPR
🇵🇸Asia/HebronPS
🇵🇹Europe/LisbonPT
🇵🇼Pacific/PalauPW
🇵🇾America/AsuncionPY
🇶🇦Asia/QatarQA
🇷🇪Indian/ReunionRE
🇷🇴Europe/BucharestRO
🇷🇸Europe/BelgradeRS
🇷🇺Europe/VolgogradRU
🇷🇼Africa/KigaliRW
🇸🇦Asia/RiyadhSA
🇸🇧Pacific/GuadalcanalSB
🇸🇨Indian/MaheSC
🇸🇩Africa/KhartoumSD
🇸🇪Europe/StockholmSE
🇸🇬Asia/SingaporeSG
🇸🇭Atlantic/St_HelenaSH
🇸🇮Europe/LjubljanaSI
🇸🇯Arctic/LongyearbyenSJ
🇸🇰Europe/BratislavaSK
🇸🇱Africa/FreetownSL
🇸🇲Europe/San_MarinoSM
🇸🇳Africa/DakarSN
🇸🇴Africa/MogadishuSO
🇸🇷America/ParamariboSR
🇸🇸Africa/JubaSS
🇸🇹Africa/Sao_TomeST
🇸🇻America/El_SalvadorSV
🇸🇽America/Lower_PrincesSX
🇸🇾Asia/DamascusSY
🇸🇿Africa/MbabaneSZ
🇹🇨America/Grand_TurkTC
🇹🇩Africa/NdjamenaTD
🇹🇫Indian/KerguelenTF
🇹🇬Africa/LomeTG
🇹🇭Asia/BangkokTH
🇹🇯Asia/DushanbeTJ
🇹🇰Pacific/FakaofoTK
🇹🇱Asia/DiliTL
🇹🇲Asia/AshgabatTM
🇹🇳Africa/TunisTN
🇹🇴Pacific/TongatapuTO
🇹🇷Europe/IstanbulTR
🇹🇹America/Port_of_SpainTT
🇹🇻Pacific/FunafutiTV
🇹🇼Asia/TaipeiTW
🇹🇿Africa/Dar_es_SalaamTZ
🇺🇦Europe/ZaporozhyeUA
🇺🇬Africa/KampalaUG
🇺🇲Pacific/WakeUM
🇺🇸Pacific/HonoluluUS
🇺🇾America/MontevideoUY
🇺🇿Asia/TashkentUZ
🇻🇦Europe/VaticanVA
🇻🇨America/St_VincentVC
🇻🇪America/CaracasVE
🇻🇬America/TortolaVG
🇻🇮America/St_ThomasVI
🇻🇳Asia/Ho_Chi_MinhVN
🇻🇺Pacific/EfateVU
🇼🇫Pacific/WallisWF
🇼🇸Pacific/ApiaWS
🇾🇪Asia/AdenYE
🇾🇹Indian/MayotteYT
🇿🇦Africa/JohannesburgZA
🇿🇲Africa/LusakaZM
🇿🇼Africa/HarareZW

Hard Flags

EmojiTimezoneComment
🇦🇨Atlantic/St_HelenaAC, Ascension Island
🇧🇻Europe/OsloBV, Bouvet Island
🇨🇵Europe/ParisCP, Clipperton Island
🇩🇬Indian/ChagosDG, Diego Garcia
🇪🇦Africa/CeutaEA, Ceuta & Melilla
🇪🇺Europe/BrusselsEU, European Union headquarters
🇭🇲Indian/KerguelenHM, Heard & McDonald Islands
🇮🇨Atlantic/CanaryIC, Canary Islands
🇹🇦Atlantic/St_HelenaTA, Tristan Da Cunha
🇺🇳America/New_YorkUN, United Nations headquarters
🇽🇰Europe/BelgradeXK, Kosovo
🏴󠁧󠁢󠁥󠁮󠁧󠁿Europe/LondonEngland
🏴󠁧󠁢󠁳󠁣󠁴󠁿Europe/LondonScotland
🏴󠁧󠁢󠁷󠁬󠁳󠁿Europe/LondonWales
🏴󠁵󠁳󠁴󠁸󠁿America/ChicagoTexas flag

Keywords

FAQs


Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc