Update "Differences" for inst calendar

Open
#367 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
48/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
clojure
Domain
documentation

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.

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.

Dominant language
Shell
Stars
107
Forks
130
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from clojure/clojurescript-site

All issues in clojure/clojurescript-site

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.