cljs-time icon indicating copy to clipboard operation
cljs-time copied to clipboard

Published 20 hours ago • verified publisher icon andrewmcveigh

Document interval vs period data types

Open nartamonov opened this issue 7 years ago • 1 comments

It seems that cljs-time supports two different data structures: interval and period. They available in public API via cljs-time.core/interval and cljs-time.core/period. Only interval is documented. What's purpose for period and what's differences from interval?

nartamonov avatar Oct 29 '17 11:10 nartamonov

Having had a quick look:

  • Intervals have a specific start and end (i.e. is between two date-times)
  • Periods is a representation of an Interval as being 2 years, 3 months and 2 days etc.

It should be apparent that you can convert any interval to a unique period, but not the other way around.

EDIT: did a bit more reading... cljs-time follows clj-time API closely, which is based on Joda time. This SO post explains interval/period/durations in Joda world.

goog.date, on which cljs-time is based, only implements intervals, but no periods.

shen-tian avatar Nov 12 '17 21:11 shen-tian