From 36f26b30e964a39b91bd5cd2bceb5aada9e78930 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Chris=20M=C3=BCller?=
 <2566282+brotkrueml@users.noreply.github.com>
Date: Tue, 24 Sep 2024 18:57:49 +0200
Subject: [PATCH] [TASK] Improve stdWrap.formattedDate

An example for a custom date/time format derived from a timestamp has been added.

Additionally, add a heading for each example to improve readability.

Releases: main, 12.4
---
 Documentation/Functions/Stdwrap.rst | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/Documentation/Functions/Stdwrap.rst b/Documentation/Functions/Stdwrap.rst
index b8369725f..f032fb9e5 100644
--- a/Documentation/Functions/Stdwrap.rst
+++ b/Documentation/Functions/Stdwrap.rst
@@ -910,7 +910,7 @@ formattedDate
     .locale
         A locale other than the locale of the site language.
 
-    ..  rubric:: Examples
+    ..  rubric:: Example: Full German output from a date/time value
 
     ..  code-block:: typoscript
         :caption: EXT:site_package/Configuration/TypoScript/setup.typoscript
@@ -925,6 +925,8 @@ formattedDate
 
     will result in "Freitag, 17. März 2023 um 03:00:00 Nordamerikanische Westküsten-Sommerzeit".
 
+    ..  rubric:: Example: Full French output from a relative date value
+
     ..  code-block:: typoscript
         :caption: EXT:site_package/Configuration/TypoScript/setup.typoscript
 
@@ -937,6 +939,19 @@ formattedDate
 
     will result in "dimanche 12 mars 2023 à 11:16:44 heure d’été du Pacifique".
 
+    ..  rubric:: Example: Custom format from a timestamp
+
+    ..  code-block:: typoscript
+        :caption: EXT:site_package/Configuration/TypoScript/setup.typoscript
+
+        lib.my_formatted_date = TEXT
+        lib.my_formatted_date {
+            value = 1679022000
+            formattedDate = Y-MM-dd'T'HH:mm:ssZ
+        }
+
+    will return the date in the ISO 8601 format: "2023-03-17T03:00:00+00:00"
+
     ..  note::
         The timezone will be taken from the setting `date.timezone` in your
         :file:`php.ini`.