summaryrefslogtreecommitdiffstats
path: root/Doc/library/datetime.rst
diff options
context:
space:
mode:
authorAlexey Izbyshev <izbyshev@ispras.ru>2019-01-12 17:21:54 (GMT)
committerTal Einat <taleinat+github@gmail.com>2019-01-12 17:21:54 (GMT)
commit1cffd0eed313011c0c2bb071c8affeb4a7ed05c7 (patch)
treecdccdc8463c1cde7df1a9c549980fa9d30a1d817 /Doc/library/datetime.rst
parentd586ccb04f79863c819b212ec5b9d873964078e4 (diff)
downloadcpython-1cffd0eed313011c0c2bb071c8affeb4a7ed05c7.zip
cpython-1cffd0eed313011c0c2bb071c8affeb4a7ed05c7.tar.gz
cpython-1cffd0eed313011c0c2bb071c8affeb4a7ed05c7.tar.bz2
bpo-34512: Document platform-specific strftime() behavior for non-ASCII format strings (GH-8948)
Diffstat (limited to 'Doc/library/datetime.rst')
-rw-r--r--Doc/library/datetime.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index db3a652..121f73b 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -2034,6 +2034,12 @@ calls the platform C library's :func:`strftime` function, and platform
variations are common. To see the full set of format codes supported on your
platform, consult the :manpage:`strftime(3)` documentation.
+For the same reason, handling of format strings containing Unicode code points
+that can't be represented in the charset of the current locale is also
+platform-dependent. On some platforms such code points are preserved intact in
+the output, while on others ``strftime`` may raise :exc:`UnicodeError` or return
+an empty string instead.
+
The following is a list of all the format codes that the C standard (1989
version) requires, and these work on all platforms with a standard C
implementation. Note that the 1999 version of the C standard added additional