Hi Kirk, Thanks for raising this. In this case, the documentation is wrong so, in my opinion, we could just fix it.
Best, David On Thu, Jan 9, 2025 at 2:52 AM Kirk True <k...@kirktrue.pro> wrote: > Hi all, > > Do we consider the CLI help/usage message as part of the publicly > documented API? > > Background: There's a bug in the help/usage message in some of the Kafka > CLI tools. For some of the tools that accept a timestamp, the help message > instructs the user to provide a date in a 'YYYY-MM-DDTHH:mm:SS.sss' format. > > However, that format is incorrect: > > - YYYY refers to the "week year" not the year (see > https://medium.com/@dangoldin/javas-simpledateformat-yyyy-vs-yyyy-f3e785523589 > ) > - SS refers to milliseconds, not seconds > - sss refers to seconds, not milliseconds > > It's a small thing, but it did lead to some confusion and it would be good > to clean it up. > > Thanks, > Kirk >