scalaj / scalaj-time   0.8

Apache License 2.0 GitHub

Idiomatic Scala wrappers for Joda Time

Scala versions: 2.11 2.10
A Scala wrapper for Joda Time


  import org.scala_tools.time.Imports._
	// returns org.joda.time.DateTime = 2009-04-27T13:25:42.659-07:00
	// returns org.joda.time.DateTime = 2009-04-27T02:45:10.313-07:00 + 2.months
  // returns org.joda.time.DateTime = 2009-06-27T13:25:59.195-07:00

  DateTime.nextMonth < + 2.months
  // returns Boolean = true to DateTime.tomorrow
	// return org.joda.time.Interval =
	//   2009-04-27T13:47:14.840/2009-04-28T13:47:14.840

	( to DateTime.nextSecond).millis
	// returns Long = 1000
	2.hours + 45.minutes + 10.seconds
	// returns org.scala_tools.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

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.

Please see Joda Time for full explanation of key concepts and API:


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.