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 (for Scala 2.9.1, Scala 2.9.2, Scala 2.9.3, Scala 2.10.x, and Scala 2.11.0!):
libraryDependencies += "com.github.nscala-time" %% "nscala-time" % "1.0.0"
Latest stable release is 1.0.0
. 0.8.0
, 0.6.0
, 0.4.2
, 0.4.0
, and 0.2.0
are also available. What you need to do to use the previous versions
is replaing 1.0.0
with x.y.z
in build.sbt simply.
- Binaries compiled with Scala 2.11.0 are included.
- nscala-time#53
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.
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 nscala-time
. If 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 asX
or toX
have
also been shortened.
import com.github.nscala_time.time.Imports._
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.