haskell / time

A time library
http://hackage.haskell.org/package/time
Other
118 stars 78 forks source link

Please provide documentation for Data.Time.Format.ISO8601 #238

Closed greydot closed 5 months ago

greydot commented 1 year ago

Hello!

Right now, it is completely unapparent how exactly this module should be used. Moreover, references to the ISO standard require the user to actually buy (or 🏴‍☠️ YAAARRRRRRR) the pdf, thus adding insult to injury.

Thank you!

AshleyYakeley commented 1 year ago

If you're not already working with ISO8601, and already have a copy of the standard, you don't need this module.

greydot commented 1 year ago

Unfortunately, I was pointed to it by the deprecation of https://hackage.haskell.org/package/time-1.12.2/docs/Data-Time-Format.html#v:iso8601DateFormat

AshleyYakeley commented 1 year ago

What format do you want?

Profpatsch commented 10 months ago

Seconded, I’d guess these all have a specific formatting string format, so giving an example in the docstring would be nice. The standard is not trivial to find nor understand unfortunately.

The implementations are not straightforward to understand so examples would help.

AshleyYakeley commented 5 months ago

Done.