DOC: Improve datetime64 docs.

[katleszek]

Adding clarification to datetime64. Resolves #14299

[melissawm]

Hello, @katleszek , can you add to the PR description a note about which issue this will close? You can check this page for more info on how to do this: https://docs.github.com/pt/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword

[rgommers]

Thanks @katleszek! The issue also talks about the "experimental" note on https://numpy.org/devdocs/reference/arrays.datetime.html that should be removed:

We can safely get rid of that now.

[rgommers]

Thanks @katleszek. The example is good, I suggest a couple of textual changes.

[katleszek]

Adding clarification to datetime64. Resolves #14299

[rgommers]

The refguide checker on Azure is unhappy:

ValueError: line 8 of the docstring for Datetime64 has inconsistent leading whitespace: "    numpy.datetime64('1980')   "

You can reproduce this failure locally by running python runtests.py --refguide-check.

[katleszek]

Thanks for the advice! Fixed the Azure unhappiness, but get a smoke_test fail - how can I check what is wrong with this one?

[mattip]

Thanks @katleszek

[eric-wieser]

Doesn't it make sense to keep this description too? This change seems to remove information about datetime64 and add information about datetime64.__new__. Ideally we'd have both!

[mattip]

Sure.