Rewrite date & time formatting

log4j-core/src/main/java/org/apache/logging/log4j/core/util/internal/instant/InstantNumberFormatter.java

@@ -27,6 +27,12 @@
  * <p>
  * <sup>1</sup> Epoch is a fixed instant on {@code 1970-01-01Z}.
  * </p>
+ * <h2>Internal usage only!</h2>
+ * <p>
+ * This class is intended only for internal Log4j usage.
+ * <b>Log4j users should not use this class!</b>
+ * This class is not subject to any backward compatibility concerns.
+ * </p>
  *
  * @since 2.25.0
  */

log4j-core/src/main/java/org/apache/logging/log4j/core/util/internal/instant/InstantPatternFormatter.java

@@ -28,6 +28,12 @@
 
 /**
  * Contract for formatting {@link Instant}s using a date & time formatting pattern.
+ * <h2>Internal usage only!</h2>
+ * <p>
+ * This class is intended only for internal Log4j usage.
+ * <b>Log4j users should not use this class!</b>
+ * This class is not subject to any backward compatibility concerns.
+ * </p>
  *
  * @since 2.25.0
  */

log4j-core/src/main/java/org/apache/logging/log4j/core/util/internal/instant/package-info.java

@@ -14,7 +14,22 @@
  * See the license for the specific language governing permissions and
  * limitations under the license.
  */
+/**
+ * Utilities for formatting log event {@link org.apache.logging.log4j.core.time.Instant}s.
+ * <h2>Internal usage only!</h2>
+ * <p>
+ * This package is intended only for internal Log4j usage.
+ * <b>Log4j users should not use this package!</b>
+ * This package is not subject to any backward compatibility concerns.
+ * </p>
+ *
+ * @since 2.25.0
+ */
+@Export
+@Version("2.25.0")
 @NullMarked
 package org.apache.logging.log4j.core.util.internal.instant;
 
 import org.jspecify.annotations.NullMarked;
+import org.osgi.annotation.bundle.Export;
+import org.osgi.annotation.versioning.Version;