formatter keys about clojure.java-time HOT 6 CLOSED

How would you parse a string with a predefined formatter?

from clojure.java-time.

Hi, sorry for not responding earlier!

There's already a set of predefined formatters supported by j/format. These are the formatters defined in java.time.format.DateTimeFormatter:

user=> (keys java-time.format/predefined-formatters)
("iso-offset-time"
 "iso-local-time"
 "iso-local-date-time"
 "iso-offset-date"
 "iso-time"
 "iso-week-date"
 "basic-iso-date"
 "rfc-1123-date-time"
 "iso-ordinal-date"
 "iso-zoned-date-time"
 "iso-instant"
 "iso-date-time"
 "iso-offset-date-time"
 "iso-date"
 "iso-local-date")

so you can do the following:

user=> (j/format :iso-offset-time (j/zoned-date-time))
"21:10:00.000+01:00"
user=> (j/format :iso-time (j/zoned-date-time))
"21:11:00.000+01:00"
user=> (j/format :iso-date-time (j/zoned-date-time))
"2018-07-12T21:12:00.000+01:00[Europe/London]"
user=> (j/format :iso-local-date (j/zoned-date-time))
"2018-07-12"

We can always improve the documentation if you think this can be made clearer. Happy to review any PR/discuss changes.

from clojure.java-time.

This is really a minor issue. It is nice that j/format does key processing, but to access the formatters hash-map directly, I made a helper function:

(defn get-formatter
  "java-time helper for referencing predefined JavaTime formatters
  `format-index` may be a string or a keyword"
  [format-index]
  (get f/predefined-formatters
          (-> format-index
                ->kebab-case
                name)))

with help from camelsnakekebab

A helper wouldn't be necessary if f/predefined-formatters had key-word keys instead of strings.

from clojure.java-time.

java-time.format/predefined-formatters is supposed to be private. The only public API namespaces are java-time and java-time.repl.

Could you please explain why you need the access to predefined formatters separately from the j/format function? Maybe we'll think of something to add to the public API.

from clojure.java-time.

How would you parse a string with a predefined formatter?

Like so:

user=> (j/format :iso-offset-time (j/zoned-date-time))
"21:10:00.000+01:00"

You can still reference predefined formats (like :iso-offset-time) without having them in a map.

See the response by dm3 cfrom Jul 12, 2018.

from clojure.java-time.

Added API comments to j/format

from clojure.java-time.