]> granicus.if.org Git - python/commitdiff
Improve f-strings documentation (GH-3604)
authorMariatta <Mariatta@users.noreply.github.com>
Sat, 16 Sep 2017 18:46:43 +0000 (11:46 -0700)
committerGitHub <noreply@github.com>
Sat, 16 Sep 2017 18:46:43 +0000 (11:46 -0700)
Provide additional examples of using format specifiers in f-strings
Added examples for using integer and date format specifiers.

Doc/reference/lexical_analysis.rst

index 1a7c6f9c753b3e384184c537403999da320edab1..baf1f09dff2a2cec44dade349c8695501cdf72a2 100644 (file)
@@ -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