풀 리퀘스트 병합 #38

feature/36

Close #36

Author: HarryJhin

build.gradle.kts

@@ -12,7 +12,7 @@ plugins {
 
 project.description = "Kotlin을 위한 java.time.* 확장 함수 라이브러리"
 project.group = "io.github.harryjhin"
-project.version = "0.13.8"
+project.version = "0.14.0"
 
 repositories {
     mavenCentral()

src/main/kotlin/io/github/harryjhin/java/time/extension/OffsetTimeExtensions.kt

@@ -0,0 +1,100 @@
+package io.github.harryjhin.java.time.extension
+
+import java.time.Duration
+import java.time.LocalDate
+import java.time.OffsetDateTime
+import java.time.OffsetTime
+
+/**
+ * [OffsetTime]의 시간을 나타내는 [Duration] 인스턴스를 반환합니다.
+ *
+ * @receiver [OffsetTime]
+ * @return 시간을 나타내는 [Duration] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.hours
+ */
+val OffsetTime.hours: Duration
+    get() = Duration.ofHours(hour.toLong())
+
+/**
+ * [OffsetTime]의 분을 나타내는 [Duration] 인스턴스를 반환합니다.
+ *
+ * @receiver [OffsetTime]
+ * @return 분을 나타내는 [Duration] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.minutes
+ */
+val OffsetTime.minutes: Duration
+    get() = Duration.ofMinutes(minute.toLong())
+
+/**
+ * [OffsetTime]의 초를 나타내는 [Duration] 인스턴스를 반환합니다.
+ *
+ * @receiver [OffsetTime]
+ * @return 초를 나타내는 [Duration] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.seconds
+ */
+val OffsetTime.seconds: Duration
+    get() = Duration.ofSeconds(second.toLong())
+
+/**
+ * [OffsetTime]의 나노초를 밀리초 단위까지 나타내는 [Duration] 인스턴스를 반환합니다.
+ *
+ * @receiver [OffsetTime]
+ * @return 나노초를 밀리초 단위까지 나타내는 [Duration] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.milliseconds
+ */
+val OffsetTime.milliseconds: Duration
+    get() = Duration.ofNanos(nano / 1_000_000L * 1_000_000L)
+
+/**
+ * [OffsetTime]의 나노초를 마이크로초 단위까지 나타내는 [Duration] 인스턴스를 반환합니다.
+ *
+ * @receiver [OffsetTime]
+ * @return 나노초를 마이크로초 단위까지 나타내는 [Duration] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.microseconds
+ */
+val OffsetTime.microseconds: Duration
+    get() = Duration.ofNanos(nano / 1_000L * 1_000L)
+
+/**
+ * [OffsetTime]의 나노초를 나노초 단위까지 나타내는 [Duration] 인스턴스를 반환합니다.
+ *
+ * @receiver [OffsetTime]
+ * @return 나노초를 나노초 단위까지 나타내는 [Duration] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.nanoseconds
+ */
+val OffsetTime.nanoseconds: Duration
+    get() = Duration.ofNanos(nano.toLong())
+
+/**
+ * [OffsetTime]을 [LocalDate]와 결합하여 [OffsetDateTime]으로 변환합니다.
+ *
+ * @receiver [OffsetTime]
+ * @param date [LocalDate]
+ * @return 결합된 [OffsetDateTime]
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.at
+ */
+infix fun OffsetTime.at(date: LocalDate): OffsetDateTime {
+    return date.atTime(this)
+}
+
+/**
+ * 두 [OffsetTime] 사이의 기간을 [Duration]으로 계산합니다.
+ *
+ * @receiver 시작 시점
+ * @param endOffsetTime 끝 시점
+ * @return 시작 시점부터 끝 시점까지의 기간
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.OffsetTimeExtensionsTest.between
+ */
+infix fun OffsetTime.between(
+    endOffsetTime: OffsetTime,
+): Duration {
+    return Duration.between(this, endOffsetTime)
+}

src/main/kotlin/io/github/harryjhin/java/time/extension/StringExtensions.kt

@@ -8,6 +8,7 @@ import java.time.LocalTime
 import java.time.Month
 import java.time.MonthDay
 import java.time.OffsetDateTime
+import java.time.OffsetTime
 import java.time.Period
 import java.time.Year
 import java.time.YearMonth
@@ -864,9 +865,105 @@ fun String.toLocalTimeOrNull(
     }
 }
 
-//fun String.toOffsetTime(): OffsetTime {
-//    return toOffsetTime(FORMATTER_OFFSET_TIME)
-//}
+/**
+ * [String]을 [OffsetTime]로 변환합니다.
+ *
+ * @receiver 오프셋 시간 문자열 (설정된 형식에 맞는)
+ * @return [OffsetTime] 인스턴스
+ * @throws DateTimeParseException 문자열 분석에 실패한 경우
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.StringExtensionsTest.toOffsetTime
+ */
+fun String.toOffsetTime(): OffsetTime {
+    return toOffsetTime(JavaTimeExtensionConfiguration.FORMATTER_OFFSET_TIME)
+}
+
+/**
+ * [String]을 [OffsetTime]로 변환합니다.
+ *
+ * @receiver 오프셋 시간 문자열
+ * @param pattern 시간 패턴 문자열
+ * @return [OffsetTime] 인스턴스
+ * @throws DateTimeParseException 문자열 분석에 실패한 경우
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.StringExtensionsTest.toOffsetTimeWithString
+ */
+fun String.toOffsetTime(
+    pattern: String,
+): OffsetTime {
+    val formatter = pattern.toDateTimeFormatter()
+    return toOffsetTime(formatter)
+}
+
+/**
+ * [String]을 [OffsetTime]로 변환합니다.
+ *
+ * @receiver 오프셋 시간 문자열
+ * @param formatter 시간 포맷터
+ * @return [OffsetTime] 인스턴스
+ * @throws DateTimeParseException 문자열 분석에 실패한 경우
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.StringExtensionsTest.toOffsetTimeWithDateTimeFormatter
+ */
+fun String.toOffsetTime(
+    formatter: DateTimeFormatter,
+): OffsetTime {
+    return OffsetTime.parse(this, formatter)
+}
+
+/**
+ * [String]을 [OffsetTime]로 변환합니다. 변환에 실패하면 `null`을 반환합니다.
+ *
+ * @receiver 오프셋 시간 문자열
+ * @return [OffsetTime] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.StringExtensionsTest.toOffsetTimeOrNull
+ */
+fun String.toOffsetTimeOrNull(): OffsetTime? {
+    return try {
+        toOffsetTime()
+    } catch (e: Exception) {
+        null
+    }
+}
+
+/**
+ * [String]을 [OffsetTime]로 변환합니다. 변환에 실패하면 `null`을 반환합니다.
+ *
+ * @receiver 오프셋 시간 문자열
+ * @param pattern 시간 패턴 문자열
+ * @return [OffsetTime] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.StringExtensionsTest.toOffsetTimeOrNullWithString
+ */
+fun String.toOffsetTimeOrNull(
+    pattern: String,
+): OffsetTime? {
+    return try {
+        toOffsetTime(pattern)
+    } catch (e: Exception) {
+        null
+    }
+}
+
+/**
+ * [String]을 [OffsetTime]로 변환합니다. 변환에 실패하면 `null`을 반환합니다.
+ *
+ * @receiver 오프셋 시간 문자열
+ * @param formatter 시간 포맷터
+ * @return [OffsetTime] 인스턴스
+ * @since 0.14.0
+ * @sample io.github.harryjhin.java.time.extension.StringExtensionsTest.toOffsetTimeOrNullWithDateTimeFormatter
+ */
+fun String.toOffsetTimeOrNull(
+    formatter: DateTimeFormatter,
+): OffsetTime? {
+    return try {
+        toOffsetTime(formatter)
+    } catch (e: Exception) {
+        null
+    }
+}
 
 /**
  * 주어진 일시 문자열을 [LocalDateTime]으로 파싱합니다. 기본 포맷 "yyyy-MM-dd'T'HH:mm:ss"를 사용합니다.