✨ feat: add unify functions for Time4j #4

Author: pnguyen215

plugin/src/main/groovy/org/unify4j/common/Time4j.java

@@ -2,6 +2,7 @@
 
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
+import org.unify4j.model.enums.TimezoneType;
 import org.unify4j.text.TimeFormatText;
 
 import java.sql.Timestamp;
@@ -1010,6 +1011,64 @@ public static String format(Date date) {
         return format(date, TimeFormatText.BIBLIOGRAPHY_EPOCH_PATTERN);
     }
 
+    /**
+     * Formats a Date object into a string representation using the specified timezone.
+     *
+     * @param date     The Date object to be formatted.
+     * @param timezone The timezone.
+     * @param format   The format string used to format the date.
+     * @return A string representation of the formatted date with the specified timezone.
+     * @throws IllegalArgumentException if the format is null or invalid.
+     */
+    public static String format(Date date, TimeZone timezone, String format) {
+        if (date == null || timezone == null || String4j.isEmpty(format)) {
+            return "";
+        }
+        SimpleDateFormat sdf = new SimpleDateFormat(format);
+        sdf.setTimeZone(timezone);
+        return sdf.format(date);
+    }
+
+    /**
+     * Formats a Date object into a string representation using the specified timezone.
+     *
+     * @param date     The Date object to be formatted.
+     * @param timezone The timezone enum type from TimezoneText enum.
+     * @param format   The format string used to format the date.
+     * @return A string representation of the formatted date with the specified timezone.
+     * @throws IllegalArgumentException if the format is null or invalid.
+     */
+    public static String format(Date date, TimezoneType timezone, String format) {
+        if (date == null || timezone == null || String4j.isEmpty(format)) {
+            return "";
+        }
+        return format(date, TimeZone.getTimeZone(timezone.getTimeZoneId()), format);
+    }
+
+    /**
+     * Formats a Date object into a string representation using the specified timezone.
+     *
+     * @param date     The Date object to be formatted.
+     * @param timezone The timezone.
+     * @return A string representation of the formatted date with the specified timezone.
+     * @throws IllegalArgumentException if the format is null or invalid.
+     */
+    public static String format(Date date, TimeZone timezone) {
+        return format(date, timezone, TimeFormatText.BIBLIOGRAPHY_EPOCH_PATTERN);
+    }
+
+    /**
+     * Formats a Date object into a string representation using the specified timezone.
+     *
+     * @param date     The Date object to be formatted.
+     * @param timezone The timezone.
+     * @return A string representation of the formatted date with the specified timezone.
+     * @throws IllegalArgumentException if the format is null or invalid.
+     */
+    public static String format(Date date, TimezoneType timezone) {
+        return format(date, timezone, TimeFormatText.BIBLIOGRAPHY_EPOCH_PATTERN);
+    }
+
     /**
      * Parses a date with the specified year, month, and day using the system default time zone.
      *

plugin/src/main/groovy/org/unify4j/model/enums/TimezoneType.java

@@ -0,0 +1,57 @@
+package org.unify4j.model.enums;
+
+import java.util.TimeZone;
+
+// @formatter:off
+@SuppressWarnings({"SpellCheckingInspection"})
+public enum TimezoneType {
+    DefaultTimezoneVietnam("Asia/Ho_Chi_Minh"),
+    DefaultTimezoneNewYork("America/New_York"),
+    DefaultTimezoneLondon("Europe/London"),
+    DefaultTimezoneTokyo("Asia/Tokyo"),
+    DefaultTimezoneSydney("Australia/Sydney"),
+    DefaultTimezoneParis("Europe/Paris"),
+    DefaultTimezoneMoscow("Europe/Moscow"),
+    DefaultTimezoneLosAngeles("America/Los_Angeles"),
+    DefaultTimezoneManila("Asia/Manila"),
+    DefaultTimezoneKualaLumpur("Asia/Kuala_Lumpur"),
+    DefaultTimezoneJakarta("Asia/Jakarta"),
+    DefaultTimezoneYangon("Asia/Yangon"),
+    DefaultTimezoneAuckland("Pacific/Auckland"),
+    DefaultTimezoneBangkok("Asia/Bangkok"),
+    DefaultTimezoneDelhi("Asia/Kolkata"), // Note: India standard time
+    DefaultTimezoneDubai("Asia/Dubai"),
+    DefaultTimezoneCairo("Africa/Cairo"),
+    DefaultTimezoneAthens("Europe/Athens"),
+    DefaultTimezoneRome("Europe/Rome"),
+    DefaultTimezoneJohannesburg("Africa/Johannesburg"),
+    DefaultTimezoneStockholm("Europe/Stockholm"),
+    DefaultTimezoneOslo("Europe/Oslo"),
+    DefaultTimezoneHelsinki("Europe/Helsinki"),
+    DefaultTimezoneKiev("Europe/Kiev"),
+    DefaultTimezoneBeijing("Asia/Shanghai"),
+    DefaultTimezoneSingapore("Asia/Singapore"),
+    DefaultTimezoneIslamabad("Asia/Karachi"),
+    DefaultTimezoneColombo("Asia/Colombo"),
+    DefaultTimezoneDhaka("Asia/Dhaka"),
+    DefaultTimezoneKathmandu("Asia/Kathmandu"),
+    DefaultTimezoneBrisbane("Australia/Brisbane"),
+    DefaultTimezoneWellington("Pacific/Auckland"), // Note: Wellington uses the same as Auckland
+    DefaultTimezonePortMoresby("Pacific/Port_Moresby"),
+    DefaultTimezoneSuva("Pacific/Fiji");
+
+    private final String timeZoneId;
+
+    TimezoneType(String timeZoneId) {
+        this.timeZoneId = timeZoneId;
+    }
+
+    public String getTimeZoneId() {
+        return timeZoneId;
+    }
+
+    public static TimeZone getTimeZone(TimezoneType timezone) {
+        return TimeZone.getTimeZone(timezone.getTimeZoneId());
+    }
+}
+// @formatter:on