makemd icon indicating copy to clipboard operation
makemd copied to clipboard

Better Documentation - For Formulas Date Time - parseDate formatDate Formats

Open Techienaut opened this issue 11 months ago • 1 comments

Hi! I struggled a lot today (as a newb) trying to understand what Standard Make.md Formulas use for various functions, such as:

  • formatDate
  • parseDate

I did some digging in the codebase, and it turns out you use date-fns library. Some more digging, and I found:

  1. formatDate uses these characters to represent parts of a datetime format: https://date-fns.org/v4.1.0/docs/format
  2. parseDate takes in either: a. unix timestamp in miliseconds (which is what timeStamp(inserDate)) also return. b. OR the ISO 8601 format: yyyy-MM-dd'T'HH:mm:ss. (source: https://date-fns.org/v4.1.0/docs/parseISO)

Well for anyone who struggles like I did--there's some documentation! I'm sure as I play around with make.md, I will find more things undocumented lol. If so, I'll make issues about it. I'm terrible at writing, so I don't want to make a commit to the documentation--until I fully understand make.md. But for now, this is my contribution.

Techienaut avatar Jan 17 '25 20:01 Techienaut

This is highly appreciated and will be added to the docs. Thanks


De : Anthony Flores @.> Envoyé : Friday, January 17, 2025 3:50:09 PM À : Make-md/makemd @.> Cc : Subscribed @.***> Objet : [Make-md/makemd] Better Documentation - For Formulas Date Time - parseDate formatDate Formats (Issue #421)

Hi! I struggled a lot today (as a newb) trying to understand what Standard Make.md Formulas use for various functions, such as:

  • formatDate
  • parseDate

I did some digging in the codebase, and it turns out you use date-fns library. Some more digging, and I found:

  1. formatDate uses these characters to represent parts of a datetime format: https://date-fns.org/v4.1.0/docs/format
  2. parseDate takes in either: a. unix timestamp in miliseconds (which is what timeStamp(inserDate)) also return. b. OR the ISO 8601 format: yyyy-MM-dd'T'HH:mm:ss. (source: https://date-fns.org/v4.1.0/docs/parseISO)

Well for anyone who struggles like I did--there's some documentation! I'm sure as I play around with make.md, I will find more things undocumented lol. If so, I'll make issues about it. I'm terrible at writing, so I don't want to make a commit to the documentation--until I fully understand make.md. But for now, this is my contribution.

— Reply to this email directly, view it on GitHubhttps://github.com/Make-md/makemd/issues/421, or unsubscribehttps://github.com/notifications/unsubscribe-auth/AAFHKNSHXWUPC5UIPVJXSQL2LFUIDAVCNFSM6AAAAABVMWGRVOVHI2DSMVQWIX3LMV43ASLTON2WKOZSG44TMMRWHEYTSMY. You are receiving this because you are subscribed to this thread.Message ID: @.***>

jp-cen avatar Jan 17 '25 20:01 jp-cen