From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 16 Sep 2017 19:01:32 +0000 (-0700)
Subject: bpo-31487: Improve f-strings documentation (GH-3604) (GH-3619)
X-Git-Tag: v3.6.3rc1~7
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=46c1052404c1a6e4d35af8e96613db8a4be75b52;p=python

bpo-31487: Improve f-strings documentation (GH-3604) (GH-3619)

Provide additional examples of using format specifiers in f-strings
Added examples for using integer and date format specifiers.
(cherry picked from commit f3618970690b08ed88e430ba8017859b4fafc3f9)
---

diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
index fff31a3ce4..3305f460d4 100644
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -676,6 +676,12 @@ Some examples of formatted string literals::
    >>> value = decimal.Decimal("12.34567")
    >>> f"result: {value:{width}.{precision}}"  # nested fields
    'result:      12.35'
+   >>> today = datetime(year=2017, month=1, day=27)
+   >>> f"{today:%b %d, %Y}"  # using date format specifier
+   'January 27, 2017'
+   >>> number = 1024
+   >>> f"{number:#0x}"  # using integer presentation type as format specifier
+   '0x400'
 
 A consequence of sharing the same syntax as regular string literals is
 that characters in the replacement fields must not conflict with the