Build Status Code Climate Test Coverage devDependency Status npm npm version Bower version Inline docs

Kairós(καιρός) is a greek word that means "the right moment". Also, in the greek mithology Kairós is the son of the personification of time itself, Chronos.

This library is being developed to be a non date-based time calculator. The aim is to use time expressions along with math expressions to have human time products, and also to have various representations of a time expression.



npm install kairos


bower install kairos


  • Basic: Basic example
  • Calculator: A calculator made with Kairos
  • Usecase: A simple application with a possible Kairos usecase


  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request


Licence © Rodrigo Gomes da Silva