paper-timezone | Vaadin

Polymer based timezone selection component

[ This description is mirrored from at on 2019-05-22 ]

Published on



paper-timezone is a Polymer based web component used for interactively selecting a timezone locale from a map. On smaller screens, the component resizes itself to a dropdown with the ability to let the user select the locale from the dropdown list. It is heavily inspired by the world map on the momentjs site; it in fact is a rewrite of the same in Polymer although with a lot more added features.

We at Blue Water Tracks use it on our portal pages and we wanted to open source the component to share it with the Polymer community. Demos and documentation can be found here

Sample screenshot

Screenshot in mobile view

bwt-datatable mobile view


  • Full compatibility with Polymer 2!
  • Extremely simple to set up.
  • Support for desktop and mobile mode using the responsive-width property.
  • Moment compatible object {location: "Asia/Bangkok", offset: 420}
  • Support for offset in minutes or hours.
  • Support for custom styling.


The element can be installed using bower using

bower install --save paper-timezone


  • Following code is required to place in the polymer web component.
<paper-timezone  name="timezone" timezone="[[timezone]]" label="Timezone (Continent/City)" error-message="Please enter a timezone offset"></paper-timezone>

Reporting Bugs

When filing a bug report, please provide an example of how to reproduce using plunker, jsbin, jsfiddle, etc.


To run the tests go to the component directory and run.

polymer test


This project is licensed under the terms of the MIT license.


We absolutely love sending us new pull requests, so let us just outline some advice:

  1. If you have an idea for a feature that you would like to be added or have a pull request for one, create an issue and we will have a look at it and let you know if we can support it.
  2. You have to explicitly agree in your pull request to the terms described in the fair share license construction.


@bhargavkonkathi Programming is like playing chess; each line is as important as each step to determine what kind of player or programmer you are. When ever not playing chess, it's Javascript, Java and mongodb.
@maisnamraju Javascript Ninja; saving the world with one line of javascript at a time. ;)
@dhrytsenko What is my opinion about JavaScript, NodeJS, MongoDB and Polymer? Building blocks to the future! Allowing me to help make the world a better place.


Link to this version
ImportedReleased 21 March 2018MIT License
Framework Support
Polymer 2.0+
Also supported:
Polymer 1 (1.1.5)
Browser Independent
Install with
bower install --save bluewatertracks/paper-timezone"#1.1.4"
Run the above Bower command in your project folder. If you have any issues installing, please contact the author.
Release notes - Version 1.1.4


  • polymer#Polymer/polymer#^2.0.0
  • paper-dialog#^2.0.0
  • paper-input#^2.0.2
  • paper-item#^2.0.0
  • iron-media-query#^2.0.0
  • moment#^2.19.1
  • moment-timezone#^0.5.13
  • paper-dropdown-menu#^2.0.0
  • paper-listbox#^2.0.0
  • webcomponentsjs#^1.0.17
  • paper-material#^2.0.0