diff --git a/core/lib/Drupal/Core/Datetime/DateFormatter.php b/core/lib/Drupal/Core/Datetime/DateFormatter.php
index 08faaee..30fcc16 100644
--- a/core/lib/Drupal/Core/Datetime/DateFormatter.php
+++ b/core/lib/Drupal/Core/Datetime/DateFormatter.php
@@ -196,11 +196,12 @@ public function formatInterval($interval, $granularity = 2, $langcode = NULL) {
    * Provides all date format characters value for given timestamp.
    *
    * @param string|null $langcode
-   *   Language code of date format. Use site default language, if not provided.
+   *   (optional) Language code of date format, if different from site
+   *   default language.
    * @param int|null $timestamp
-   *   Unix timestamp to format. Use REQUEST_TIME if not provided.
+   *   (optional) Unix timestamp to format. Use REQUEST_TIME if not provided.
    * @param string|null $timezone
-   *   String timezone. Use site default timezone, if not provided.
+   *   (optional) String timezone, if different from site default timezone.
    *
    * @return array
    *   An array of formatted date value indexed by date character.