clojure / clojure/clojurescript-site
Update "Differences" for inst calendar
Nobody has claimed this yet.
- Dominant language
- Shell
- Stars
- 107
- Forks
- 130
- PR merge metrics
- No merged PRs in 30d
Description
When #inst values are parsed and printed in Clojure, by default the Gregorian calendar is used. In particular, this is a hybrid Julian / Gregorian calendar with a changeover in 1582.
On the other hand, ClojureScript uses the JavaScripts Date type for #inst values, which employs a proleptic Gregorian calendar. This host-specific aspect is reflected in #inst parsing and printing.
A consequence of this difference in default #inst handling is that older dates will be interpreted differently. For example #inst "1500" denotes two different instances in time in Clojure vs. ClojureScript.
This could be detailed in the "Differences" page, perhaps in the reader section.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at the site's “Differences” page and locate the reader section mentioned in the issue. Document the differing default calendars used for #inst parsing and printing, including the older-date consequence and the #inst "1500" example; the page should clearly explain the Clojure versus ClojureScript behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- clojure
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100