enforced formatting requirements

Author: Mcbencrafter

snippets/java/date-time/date-time-formatting-american.md

@@ -2,7 +2,7 @@
 title: Date time formatting american
 description: Formats a timestamp to a human-readable date-time string in the format "MM/dd/yyyy hh:mm:ss a"
 author: Mcbencrafter
-tags: date, time, date-time, formatting, american
+tags: date,time,date-time,formatting,american
 ---
 
 ```java
@@ -11,26 +11,22 @@ import java.time.ZoneId;
 import java.time.format.DateTimeFormatter;
 import java.util.concurrent.TimeUnit;
 
-public class DateTimeFormatterAmerican {
-
-    public static void main(String[] args) {
-        System.out.println(formatDateTimeAmerican(1735689599, TimeUnit.SECONDS)); // "12/31/2024 | 11:59:59 PM" for GMT+0000
-        System.out.println(formatDateTimeAmerican(1735689599, TimeUnit.SECONDS, ZoneId.of("GMT+0000"))); // "12/31/2024 | 11:59:59 PM"
-    }
+// using the system default time zone
+public static String formatDateTimeAmerican(long time, TimeUnit timeUnit) {
+    return formatDateTimeAmerican(time, timeUnit, ZoneId.systemDefault());
+}
 
-    // using the system default time zone
-    public static String formatDateTimeAmerican(long time, TimeUnit timeUnit) {
-        return formatDateTimeAmerican(time, timeUnit, ZoneId.systemDefault());
-    }
-    
-    public static String formatDateTimeAmerican(long time, TimeUnit timeUnit, ZoneId timeZone) {
-        return DateTimeFormatter.ofPattern("MM/dd/yyyy hh:mm:ss a")
-                .withZone(
-                    timeZone != null ? timeZone : ZoneId.systemDefault()
-                )
-                .format(Instant.ofEpochSecond(
-                    timeUnit.toSeconds(time)
-                ));
-    }
+public static String formatDateTimeAmerican(long time, TimeUnit timeUnit, ZoneId timeZone) {
+    return DateTimeFormatter.ofPattern("MM/dd/yyyy hh:mm:ss a")
+            .withZone(
+                timeZone != null ? timeZone : ZoneId.systemDefault()
+            )
+            .format(Instant.ofEpochSecond(
+                timeUnit.toSeconds(time)
+            ));
 }
+
+// Usage:
+System.out.println(formatDateTimeAmerican(1735689599, TimeUnit.SECONDS)); // "12/31/2024 | 11:59:59 PM" for GMT+0000
+System.out.println(formatDateTimeAmerican(1735689599, TimeUnit.SECONDS, ZoneId.of("GMT+0000"))); // "12/31/2024 | 11:59:59 PM"
 ```

snippets/java/date-time/date-time-formatting-european.md

@@ -2,7 +2,7 @@
 title: Date time formatting european
 description: Formats a timestamp to a human-readable date-time string in the format "dd.MM.yyyy HH:mm:ss"
 author: Mcbencrafter
-tags: date, time, date-time, formatting, european
+tags: date,time,date-time,formatting,european
 ---
 
 ```java
@@ -11,26 +11,22 @@ import java.time.ZoneId;
 import java.time.format.DateTimeFormatter;
 import java.util.concurrent.TimeUnit;
 
-public class DateTimeFormatterEuropean {
-
-    public static void main(String[] args) {
-        System.out.println(formatDateTimeEuropean(1735689599, TimeUnit.SECONDS)); // "31.12.2024 | 23:59:59" for GMT+0000
-        System.out.println(formatDateTimeEuropean(1735689599, TimeUnit.SECONDS, ZoneId.of("GMT+0000"))); // "31.12.2024 | 23:59:59"
-    }
+// using the system default time zone
+public static String formatDateTimeEuropean(long time, TimeUnit timeUnit) {
+    return formatDateTimeEuropean(time, timeUnit, ZoneId.systemDefault());
+}
 
-    // using the system default time zone
-    public static String formatDateTimeEuropean(long time, TimeUnit timeUnit) {
-        return formatDateTimeEuropean(time, timeUnit, ZoneId.systemDefault());
-    }
-    
-    public static String formatDateTimeEuropean(long time, TimeUnit timeUnit, ZoneId timeZone) {
-        return DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm:ss")
-                .withZone(
-                    timeZone != null ? timeZone : ZoneId.systemDefault()
-                )
-                .format(Instant.ofEpochSecond(
-                        timeUnit.toSeconds(time)
-                ));
-    }
+public static String formatDateTimeEuropean(long time, TimeUnit timeUnit, ZoneId timeZone) {
+    return DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm:ss")
+            .withZone(
+                timeZone != null ? timeZone : ZoneId.systemDefault()
+            )
+            .format(Instant.ofEpochSecond(
+                    timeUnit.toSeconds(time)
+            ));
 }
+
+// Usage:
+System.out.println(formatDateTimeEuropean(1735689599, TimeUnit.SECONDS)); // "31.12.2024 | 23:59:59" for GMT+0000
+System.out.println(formatDateTimeEuropean(1735689599, TimeUnit.SECONDS, ZoneId.of("GMT+0000"))); // "31.12.2024 | 23:59:59"
 ```

snippets/java/date-time/duration-formatting-hours-minutes-seconds.md

@@ -2,38 +2,32 @@
 title: Duration formatting hours minutes seconds
 description: Converts a given time duration to a human-readable string in the format "hh:mm(:ss)"
 author: Mcbencrafter
-tags: time, formatting, hours, minutes, seconds
+tags: time,formatting,hours,minutes,seconds
 ---
 
 ```java
-package snippets.time;
-
 import java.util.concurrent.TimeUnit;
-
-public class DurationFormatterHoursMinutesSeconds {
-
-    public static void main(String[] args) {
-        System.out.println(formatDurationToHoursMinutesAndSeconds(3810, TimeUnit.SECONDS, true)); // "01:03:30"
-        System.out.println(formatDurationToHoursMinutesAndSeconds(3810, TimeUnit.SECONDS, false)); // "01:03"
-    }
-
-    public static String formatDurationToHoursMinutesAndSeconds(int time, TimeUnit timeUnit, boolean showSeconds) {
-        long totalSeconds = timeUnit.toSeconds(time);
-
-        if (totalSeconds < 0)
-            throw new IllegalArgumentException("Duration must be a non-negative value.");
-
-        // These variables can be directly used in the return statement,
-        // but are kept as separate variables here for better readability.
-        long hours = totalSeconds / 3600;
-        long minutes = (totalSeconds % 3600) / 60;
-        long seconds = totalSeconds % 60;
-
-        if (showSeconds) {
-            return String.format("%02d:%02d:%02d", hours, minutes, seconds);
-        } else {
-            return String.format("%02d:%02d", hours, minutes);
-        }
+    
+public static String formatDurationToHoursMinutesAndSeconds(int time, TimeUnit timeUnit, boolean showSeconds) {
+    long totalSeconds = timeUnit.toSeconds(time);
+
+    if (totalSeconds < 0)
+        throw new IllegalArgumentException("Duration must be a non-negative value.");
+
+    // These variables can be directly used in the return statement,
+    // but are kept as separate variables here for better readability.
+    long hours = totalSeconds / 3600;
+    long minutes = (totalSeconds % 3600) / 60;
+    long seconds = totalSeconds % 60;
+
+    if (showSeconds) {
+        return String.format("%02d:%02d:%02d", hours, minutes, seconds);
+    } else {
+        return String.format("%02d:%02d", hours, minutes);
     }
 }
+
+// Usage:
+System.out.println(formatDurationToHoursMinutesAndSeconds(3810, TimeUnit.SECONDS, true)); // "01:03:30"
+System.out.println(formatDurationToHoursMinutesAndSeconds(3810, TimeUnit.SECONDS, false)); // "01:03"
 ```

snippets/java/date-time/duration-formatting-minutes-seconds.md

@@ -2,31 +2,27 @@
 title: Duration formatting minutes seconds
 description: Converts a given time duration to a human-readable string in the format "mm:ss"
 author: Mcbencrafter
-tags: time, formatting, minutes, seconds
+tags: time,formatting,minutes,seconds
 ---
 
 ```java
 import java.util.concurrent.TimeUnit;
 
-class DurationFormatterMinutesSeconds {
+public static String formatDurationToMinutesAndSeconds(int time, TimeUnit timeUnit) {
+    long totalSeconds = timeUnit.toSeconds(time);
 
-    public static void main(String[] args) {
-        System.out.println(formatDurationToMinutesAndSeconds(120, TimeUnit.SECONDS)); // "02:00"
-        System.out.println(formatDurationToMinutesAndSeconds(75, TimeUnit.SECONDS)); // "01:15"
-    }
+    if (totalSeconds < 0)
+        throw new IllegalArgumentException("Duration must be a non-negative value.");
 
-    public static String formatDurationToMinutesAndSeconds(int time, TimeUnit timeUnit) {
-        long totalSeconds = timeUnit.toSeconds(time);
+    // These variables can be directly used in the return statement,
+    // but are kept here as separate variables for better readability.
+    long minutes = totalSeconds / 60;
+    long seconds = totalSeconds % 60;
 
-        if (totalSeconds < 0)
-            throw new IllegalArgumentException("Duration must be a non-negative value.");
-
-        // These variables can be directly used in the return statement,
-        // but are kept here as separate variables for better readability.
-        long minutes = totalSeconds / 60;
-        long seconds = totalSeconds % 60;
-
-        return String.format("%02d:%02d", minutes, seconds);
-    }
+    return String.format("%02d:%02d", minutes, seconds);
 }
+
+// Usage:
+System.out.println(formatDurationToMinutesAndSeconds(120, TimeUnit.SECONDS)); // "02:00"
+System.out.println(formatDurationToMinutesAndSeconds(75, TimeUnit.SECONDS)); // "01:15"
 ```