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
>

Reply via email to