Minor javadoc improvement for #1786

FasterXML · Mar 23, 2019 · 46669c7 · 46669c7
1 parent c0cd01a
commit 46669c7
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 1 deletion.
diff --git a/src/main/java/com/fasterxml/jackson/databind/util/StdDateFormat.java b/src/main/java/com/fasterxml/jackson/databind/util/StdDateFormat.java
@@ -16,6 +16,13 @@
  * serializers and deserializers. For serialization defaults to using
  * an ISO-8601 compliant format (format String "yyyy-MM-dd'T'HH:mm:ss.SSSZ")
  * and for deserialization, both ISO-8601 and RFC-1123.
+ *<br>
+ * Note that `Z` in format String refers to RFC-822 timezone notation which produces
+ * values like "-0800" -- that is, full minute/hour combo without colon, and not using `Z`
+ * as alias for "+0000".
+ *<p>
+ * Note also that to enable use of colon in timezone is possible by using method
+ * {@link #withColonInTimeZone} for creating new differently configured format instance.
  */
 @SuppressWarnings("serial")
 public class StdDateFormat
@@ -145,6 +152,8 @@ public class StdDateFormat
 
     /** 
      * Whether the TZ offset must be formatted with a colon between hours and minutes ({@code HH:mm} format)
+     *<p>
+     * Defaults to {@code false} for backwards compatibility reasons
      *
      * @since 2.9.1
      */

diff --git a/src/test/java/com/fasterxml/jackson/databind/util/ISO8601DateFormatTest.java b/src/test/java/com/fasterxml/jackson/databind/util/ISO8601DateFormatTest.java
@@ -3,7 +3,6 @@
 import java.text.DateFormat;
 import java.util.*;
 
-
 import com.fasterxml.jackson.databind.BaseMapTest;
 
 @SuppressWarnings("deprecation")