Readme — tick 0.4.17-alpha

tick

A Clojure(Script) library for dealing with time. Intended as a replacement for clj-time.

Based on Java 8 time (on the JVM) and js-joda (on JavaScript runtimes).

(require [tick.alpha.api :as t])

;; Get the current time
(t/now)

See Henry Widd’s talk at Clojure/North 2019 for some background

Status

Alpha: Ready to use with the caveat that the API might still undergo minor changes.

Install

Get the latest from Clojars and add to your project.clj, build.boot or deps.edn.

To use tick with Shadow-CLJS, there are some extra steps

Development

Develop The Documentation Site

Build the Cljs --- make dev-docs-cljs ---

Build the html --- make docs/index.html ---

Serve the docs directory and navigate to it in a browser

with Clojure

REPL with nREPL server

clj -Adev

Port is written to .nrepl-port.

Run tests with:

make test

with ClojureScript

Various options:

make figwheel

Then navigate to http://localhost:9500/figwheel-extra-main/auto-testing

Or, From the Clojure REPL type (node) to get a node repl.

Acknowledgements

Tick is based on the same original idea as Chime. The motivation is to be able to view timelines of remaining times while the schedule is running. Thanks to James Henderson for his work on Chime.

In particular, special credit to Eric Evans for discovering Allen’s interval algebra and pointing out its potential usefulness, demonstrating a working implementation of Allen’s ideas in his Clojure library.

Thanks also to my esteemed colleagues Patrik Kårlin for his redesign of the interval constructor function, and Henry Widd for porting to cljc.

Copyright & License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.