[SPARK-50396][PYTHON][DOCS] Refine the docstring for datetime functio…

…ns - part 3

### What changes were proposed in this pull request?
Refine the docstring for datetime functions

### Why are the changes needed?
to improve docs and test coverage

### Does this PR introduce _any_ user-facing change?
doc-only changes

### How was this patch tested?
new doctests

### Was this patch authored or co-authored using generative AI tooling?
no

Closes #48935 from zhengruifeng/py_doc_8.

Authored-by: Ruifeng Zheng <ruifengz@apache.org>
Signed-off-by: Max Gekk <max.gekk@gmail.com>