Java Time Kotlin extension functions.
Background
Java Time became integrated to the JDK as of Java 8. It was a huge improvement over its Date predecessor.
Java Time Fun library empowers Java Time even more, making usage of dates & times a breeze.
What's In It?
1. Parsing
// Provided time
val result = "01:30 AM".parseLocalTime()
// Provided local date
val result = "2021-06-07".parseLocalDate()
// Provided ambiguous date formats
val result = "06/07/2021".parseLocalDate(format = "MM/dd/yyyy")
// Automatic time zone conversions
val result = "2021-10-04T10:10:00+0000".parseZonedDateTime()
// Maintain original time zone
val result = "2021-10-04T10:10:00+0000".parseZonedDateTime(useSystemTimeZone = false)
// Parse LocalDate as ZonedDateTime
val result = "2021-06-07".parseZonedDateTime()
2. Creation
val result = ZonedDateTimeUtil.new(year = 2021, month = 3, day = 25)
val result = LocalDateTimeUtil.new(Date())
val result = LocalDateUtil.new(GregorianCalendar())
val result = LocalTimeUtil.new(hour = 5, minute = 30)
3. Comparisons
// Year
val result = dateA.compareYear(dateB)
val result = dateA.isBeforeYear(dateB)
// Month
val result = dateA.compareMonth(dateB)
val result = dateA.getMonthDifference(dateB)
val result = dateA.isEqualMonth(dateB)
// Day
val result = dateA.compareDay(dateB)
val result = dateA.getDayDifference(dateB)
val result = dateA.isAfterEqualDay(dateB)
// Time
val result = dateA.compareTime(dateB)
val result = dateA.getMinuteDifference(dateB)
val result = dateA.isAfterEqualTime(dateB)
4. Print
val date = "2021-07-06".parseZonedDateTime()
val result = date.print(format = "MM/dd/yyyy")
5. Attributes
val result = date.isAtStartOfDay()
val result = date.getDaysInMonth()
6. Mutations
val result = date.atStartOfDay()
val result = date.getLast(DayOfWeek.FRIDAY)
val result = date.getNext(DayOfWeek.MONDAY)
7. Preset Dates
val result = ZonedDateTimes.today
val result = LocalDateTimes.tomorrow
val result = LocalDates.nextMonday
How to install?
Add to root build.gradle:
allprojects {
repositories {
maven { url 'https://jitpack.io' } // last line
}
}
Add to module build.gradle:
dependencies {
implementation 'com.github.seljabali:java-time-fun:0.5'
}
For Android
In addition to the above, you need to desugar your module:
- Ensure you're using Gradle Plugin 4.0.0+.
- Update module
build.gradle:
android {
defaultConfig {
// Required when setting minSdkVersion to 20 or lower
multiDexEnabled true
}
compileOptions {
// Flag to enable support for the new language APIs
coreLibraryDesugaringEnabled true
// Sets Java compatibility to Java 8
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
dependencies {
coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.5'
}
For more information on Android desugaring click here.
2 Oct 7, 2022
2.7k Dec 29, 2022
3.4k Jan 3, 2023
1.5k Jan 7, 2023
216 Dec 6, 2022
41 Aug 13, 2022
49 Oct 28, 2022
181 Dec 22, 2022
16 Sep 14, 2022
1.3k Jan 4, 2023
681 Dec 19, 2022
39 Nov 11, 2022
2.6k Dec 9, 2022
1.6k Jan 5, 2023
2.3k Jan 4, 2023
4.7k Dec 29, 2022
1 Mar 12, 2022
1 Jan 8, 2022
71 Dec 28, 2022