A new Scala wrapper for Joda Time. This project forked from scala-time since it seems that scala-time is no longer maintained.
Add the following to your sbt build (Scala 2.10.x, 2.11.x and 2.12.x):
libraryDependencies += "com.github.nscala-time" %% "nscala-time" % "2.20.0"
if you want to use previous versions, you can find it from here
- change private
- Drop Scala 2.9.3 support
- joda-time 2.9.3
- adding the flexibility to include format for local date and date time. See scaladoc
- joda-time 2.8.2
- Add parentheses to methods which are not purely-functional
object BuilderImplicitsshould not extends
- Add method to convert an interval into a collection
- joda-time 2.7
- Add arithmetic and others methods to Duration, Interval, and Period
- joda-time 2.5
- drop Scala 2.9.1 and 2.9.2 support
- conversion to and from scala std duration
- Added static method wrappers
- joda-time 2.4 support
- Remove implicit DateMidnightOrdering
- Add toInterval to RichString
- Add millis method to RichDateTime
- Remove deprecated class RichMidnight
- Make DurationBuilder public
- Binaries compiled with Scala 2.11.0 are included.
Binaries compiled with Scala 2.11.0-M8 are included.
Two major changes has been introduced in 0.6.0:
Although I believe that these changes don't break your code, if you have some problems, don't mind reporting the problem to issues.
Version Numbering Policy
x.y.z, each letter is digit, format is used as version number. Meanings of
x is not determined yet.
y means major-version. Note that
y is even number in any version of released
y is odd, it's development and/or SNAPSHOT version.
z is mainly used for bug fix releases. Currently, the value of
z is 0 in most cases.
This is mostly a convenience wrapper around the Joda Time libraries, adding more pleasant syntax like operators for addition, subtraction, and comparison. Also, most fields usually available as
getField are now simply available as
field, following the Scala convention. Some instances of
toX have also been shortened.
DateTime.now() + 2.months // returns org.joda.time.DateTime = 2009-06-27T13:25:59.195-07:00 DateTime.nextMonth < DateTime.now() + 2.months // returns Boolean = true DateTime.now() to DateTime.tomorrow // return org.joda.time.Interval = > 2009-04-27T13:47:14.840/2009-04-28T13:47:14.840 (DateTime.now() to DateTime.nextSecond).millis // returns Long = 1000 2.hours + 45.minutes + 10.seconds // returns com.github.nscala_time.time.DurationBuilder // (can be used as a Duration or as a Period) (2.hours + 45.minutes + 10.seconds).millis // returns Long = 9910000 2.months + 3.days // returns Period
DateTime.now() // returns org.joda.time.DateTime = 2009-04-27T13:25:42.659-07:00 DateTime.now().hour(2).minute(45).second(10) // returns org.joda.time.DateTime = 2009-04-27T02:45:10.313-07:00
Please see Joda Time for full explanation of key concepts and API: http://www.joda.org/joda-time/
Documentation of joda-time will be also a help.
The Java Date and Calendar libraries are largely inadequate. They are mutable, not thread-safe, and very inconvenient to use.
The Joda Time library is a great replacement for Java's Date and Calendar classes. They're immutable by default, have a much richer and nicer API, and can easily be converted to Java's Date and Calendar classes when necessary.
This project provides a thin layer of convenience around the Joda Time libraries, making them more idiomatic to use within Scala.