add convertLocalDateTimeToInstant method to TimeOperator, bump version to 0.9.4 in README and build.gradle.kts

Author: mahdibohloul

README.md

@@ -71,7 +71,7 @@ and formatting tools to accelerate development and maintain consistency across p
 <dependency>
     <groupId>box.tapsi.libs</groupId>
     <artifactId>utilities-starter</artifactId>
-    <version>0.9.3</version>
+    <version>0.9.4</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -10,7 +10,7 @@ plugins {
 }
 
 group = "box.tapsi.libs"
-version = "0.9.3"
+version = "0.9.4"
 description = "utilities-starter"
 
 repositories {

src/main/kotlin/box/tapsi/libs/utilities/time/TimeOperator.kt

@@ -4,6 +4,7 @@ import java.time.DayOfWeek
 import java.time.Duration
 import java.time.Instant
 import java.time.LocalDate
+import java.time.LocalDateTime
 import java.time.LocalTime
 import java.util.concurrent.TimeUnit
 
@@ -103,6 +104,18 @@ interface TimeOperator {
    */
   fun convertLocalDateToInstant(localDate: LocalDate, timezone: SupportedTimezone = SupportedTimezone.Tehran): Instant
 
+  /**
+   * Converts a LocalDateTime to an Instant using the provided timezone.
+   *
+   * @param localDateTime the LocalDateTime object to be converted.
+   * @param timezone the timezone to be used for the conversion. Defaults to SupportedTimezone.Tehran.
+   * @return the corresponding Instant representation of the provided LocalDateTime in the specified timezone.
+   */
+  fun convertLocalDateTimeToInstant(
+    localDateTime: LocalDateTime,
+    timezone: SupportedTimezone = SupportedTimezone.Tehran,
+  ): Instant
+
   /**
    * Retrieves the current local date based on the specified timezone.
    *

src/main/kotlin/box/tapsi/libs/utilities/time/TimeOperatorImpl.kt

@@ -4,6 +4,7 @@ import java.time.DayOfWeek
 import java.time.Duration
 import java.time.Instant
 import java.time.LocalDate
+import java.time.LocalDateTime
 import java.time.LocalTime
 import java.util.concurrent.TimeUnit
 
@@ -52,6 +53,11 @@ class TimeOperatorImpl : TimeOperator {
     timezone: SupportedTimezone,
   ): Instant = localDate.atStartOfDay(timezone.asZoneId()).toInstant()
 
+  override fun convertLocalDateTimeToInstant(
+    localDateTime: LocalDateTime,
+    timezone: SupportedTimezone,
+  ): Instant = localDateTime.atZone(timezone.asZoneId()).toInstant()
+
   override fun getCurrentLocalDate(timezone: SupportedTimezone): LocalDate = LocalDate.now(timezone.asZoneId())
 
   override fun getCurrentDayOfWeek(timezone: SupportedTimezone): DayOfWeek = getCurrentLocalDate(timezone).dayOfWeek