Document new timestamp format style

Author: Sacul0457

discord/utils.py

@@ -1223,31 +1223,35 @@ def is_inside_class(func: Callable[..., Any]) -> bool:
     return not remaining.endswith('<locals>')
 
 
-TimestampStyle = Literal['f', 'F', 'd', 'D', 't', 'T', 'R']
+TimestampStyle = Literal['f', 'F', 'd', 'D', 't', 'T', 's', 'S', 'R']
 
 
 def format_dt(dt: datetime.datetime, /, style: Optional[TimestampStyle] = None) -> str:
     """A helper function to format a :class:`datetime.datetime` for presentation within Discord.
 
     This allows for a locale-independent way of presenting data using Discord specific Markdown.
 
-    +-------------+----------------------------+-----------------+
-    |    Style    |       Example Output       |   Description   |
-    +=============+============================+=================+
-    | t           | 22:57                      | Short Time      |
-    +-------------+----------------------------+-----------------+
-    | T           | 22:57:58                   | Long Time       |
-    +-------------+----------------------------+-----------------+
-    | d           | 17/05/2016                 | Short Date      |
-    +-------------+----------------------------+-----------------+
-    | D           | 17 May 2016                | Long Date       |
-    +-------------+----------------------------+-----------------+
-    | f (default) | 17 May 2016 22:57          | Short Date Time |
-    +-------------+----------------------------+-----------------+
-    | F           | Tuesday, 17 May 2016 22:57 | Long Date Time  |
-    +-------------+----------------------------+-----------------+
-    | R           | 5 years ago                | Relative Time   |
-    +-------------+----------------------------+-----------------+
+    +-------------+--------------------------------+-------------------------+
+    |    Style    |        Example Output          |       Description       |
+    +=============+================================+=========================+
+    | t           | 22:57                          | Short Time              |
+    +-------------+--------------------------------+-------------------------+
+    | T           | 22:57:58                       | Medium Time             |
+    +-------------+--------------------------------+-------------------------+
+    | d           | 17/05/2016                     | Short Date              |
+    +-------------+--------------------------------+-------------------------+
+    | D           | May 17, 2016                   | Long Date               |
+    +-------------+--------------------------------+-------------------------+
+    | f (default) | May 17, 2016 at 22:57          | Long Date, Short Time   |
+    +-------------+--------------------------------+-------------------------+
+    | F           | Tuesday, May 17, 2016 at 22:57 | Full Date, Short Time   |
+    +-------------+--------------------------------+-------------------------+
+    | s           | 17/05/2016, 22:57              | Short Date, Short Time  |
+    +-------------+--------------------------------+-------------------------+
+    | S           | 17/05/2016, 22:57:58           | Short Date, Medium Time |
+    +-------------+--------------------------------+-------------------------+
+    | R           | 5 years ago                    | Relative Time           |
+    +-------------+--------------------------------+-------------------------+
 
     Note that the exact output depends on the user's locale setting in the client. The example output
     presented is using the ``en-GB`` locale.