Island Time ThreetenAbp Extensions

Integration with the Android backport of the java.time library

License

License

GroupId

GroupId

io.islandtime
ArtifactId

ArtifactId

threetenabp-extensions
Last Version

Last Version

0.2.4-1.4-rc
Release Date

Release Date

Type

Type

aar
Description

Description

Island Time ThreetenAbp Extensions
Integration with the Android backport of the java.time library
Project URL

Project URL

https://islandtime.io
Source Code Management

Source Code Management

https://github.com/erikc5000/island-time

Download threetenabp-extensions

How to add to project

<!-- https://jarcasting.com/artifacts/io.islandtime/threetenabp-extensions/ -->
<dependency>
    <groupId>io.islandtime</groupId>
    <artifactId>threetenabp-extensions</artifactId>
    <version>0.2.4-1.4-rc</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/io.islandtime/threetenabp-extensions/
implementation 'io.islandtime:threetenabp-extensions:0.2.4-1.4-rc'
// https://jarcasting.com/artifacts/io.islandtime/threetenabp-extensions/
implementation ("io.islandtime:threetenabp-extensions:0.2.4-1.4-rc")
'io.islandtime:threetenabp-extensions:aar:0.2.4-1.4-rc'
<dependency org="io.islandtime" name="threetenabp-extensions" rev="0.2.4-1.4-rc">
  <artifact name="threetenabp-extensions" type="aar" />
</dependency>
@Grapes(
@Grab(group='io.islandtime', module='threetenabp-extensions', version='0.2.4-1.4-rc')
)
libraryDependencies += "io.islandtime" % "threetenabp-extensions" % "0.2.4-1.4-rc"
[io.islandtime/threetenabp-extensions "0.2.4-1.4-rc"]

Dependencies

compile (2)

Group / Artifact Type Version
com.jakewharton.threetenabp : threetenabp jar 1.2.4
org.jetbrains.kotlin : kotlin-stdlib jar 1.4.0-rc

runtime (1)

Group / Artifact Type Version
io.islandtime : core jar 0.2.4-1.4-rc

Project Modules

There are no modules declared in this project.

Build Status License Maven Central

Island Time

A Kotlin Multiplatform library for working with dates and times, heavily inspired by the java.time library.

Features:

  • A full set of date-time primitives such as Date, Time, DateTime, Instant, and ZonedDateTime
  • Time zone database support
  • Date ranges and time intervals, integrating with Kotlin ranges and progressions
  • Read and write strings in ISO formats
  • DSL-based definition of custom parsers
  • Access localized text for names of months, days of the week, time zones, etc.
  • Convenience operators like date.next(MONDAY), dateTime.startOfWeek, or date.week(WeekSettings.systemDefault())
  • Convert to and from platform-specific date-time types
  • Works on JVM, Android, iOS, macOS, tvOS, and watchOS

Notable Limitations:

  • No custom format strings (must write platform-specific code to do this)
  • No support for JavaScript or non-Apple native platforms
  • Only supports the ISO calendar system

Island Time is still early in development and "moving fast" so to speak. The API is likely to experience changes between minor version increments.

See the project website for more information along with the API reference docs.

Feedback/Contributions

The goal of this project is not just to port the java.time library over to Kotlin Multiplatform, but to take full advantage of Kotlin language features to create a date-time DSL that feels natural to users of the language and encourages best practices where possible. To that end, any and all feedback would be much appreciated in helping to iron out the API.

If you're interested in contributing or have ideas on areas that can be improved (there are definitely many right now), please feel free to initiate a dialog by opening design-related issues or submitting pull requests.

Versions

Version
0.2.4-1.4-rc
0.2.4-1.4-M3
0.2.4
0.2.3-1.4-M3
0.2.3
0.2.2
0.2.1
0.2.0
0.1.0