cats-time

Build Status Maven Central

Instances for Cats Typeclasses for Java 8 Time. Similar to the encoding that are offered in Circe and Cormorant.

Time is a pain to deal with reasonably. So tread with caution.

Quick Start

To use cats-time in an existing SBT project with Scala 2.11 or a later version, add the following dependencies to your build.sbt depending on your needs:

libraryDependencies ++= Seq(
  "org.typelevel" %% "cats-time"     % "0.5.0"
)

Examples

First lets start with some imports.

import org.typelevel.cats.time._
import cats.implicits._
import java.time._

Then we can display the Show instances.

Duration.ofDays(3).show
// res0: String = "PT72H"

Instant.now.show
// res1: String = "2022-06-26T05:29:48.701Z"

LocalDate.now.show
// res2: String = "2022-06-26"

LocalDateTime.now.show
// res3: String = "2022-06-26T05:29:48.704"

LocalTime.now.show
// res4: String = "05:29:48.705"

MonthDay.now.show
// res5: String = "6-26"

OffsetDateTime.now.show
// res6: String = "2022-06-26T05:29:48.709Z"

OffsetTime.now.show
// res7: String = "05:29:48.711Z"

Period.ofWeeks(6).show
// res8: String = "P42D"

Year.now.show
// res9: String = "2022"

YearMonth.now.show
// res10: String = "2022-06"

ZoneId.systemDefault.show
// res11: String = "Etc/UTC"

ZonedDateTime.now.show
// res12: String = "2022-06-26T05:29:48.718Z[Etc/UTC]"