Atom Packages Directory

a package directory for a text editor of the 21st Century

Clock by Antonio Bevilacqua

Install with:
    apm install atom-clock


Build Deps! Installs! Version! License

Display a customizable clock in the status bar.


The clock can be installed through Atom. Alternatively, you can use apm:

apm install atom-clock



Date format

It specifies the format to use when displaying the date. The package uses moment.js to format the time, so please refer to the related moment.js documentation. The default value for the date format is H:mm.


It specifies the locale the clock will use when displaying the time. Its default value is en. Please check the moment.js locale folder for a complete list of all supported locales.

Clock interval

It specifies how many seconds should run between two time updates, and it is defaulted to 60 (one update per minute).

Show icon

If ticked, a clock icon will be shown to the left of the time. It is unticked by default.

Some examples

format description display
H:mm default date format Default format
h:mm a am/pm format AM/PM format
DD/MM/YYYY, H:mm short date format Short format
MMMM Do, dddd, h:mm:ss a long date format Long format
[Quarter] Q, MMMM Do YYYY, ddd, h:mm a space waster format Useless format


When a different locale is specified in the settings, the date language will change accordingly. A locale can be defined with its substring, and moment.js will take care of selecting the first locale it knows. A substring can be specified in many ways. As example, the Chinese locale for China can be expressed as zh-cn, zh_cn, zh-CN or zh_CN.

Here are some examples for locales different from English.

locale code display
Arabic ar Arabic
Belarusian be Belarusian
Tibetan bo Tibetan
Russian ru Russian
Chinese zh_CN Chinese_China


Like what you see? Please, feel free to fork this repository, and make any change you like. If you want to propose a nice feature, please create a separate branch on your fork, named after the feature you want to implement, then make a pull request from that branch. Also, before actually getting to work, just consider I’m trying to keep this package as simple and minimal as possible!

Save the clock tower!

Beerpay Beerpay Flattr this git repo

Save the clock

Keywords: clock, time, date, statusbar, momentjs Suggest keywords
Fork me on GitHub