Idiomatic Scala wrappers for Joda Time
Scala Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
notes Bump to 0.4-SNAPSHOT May 31, 2011
project Modernized build tools and scala versions Feb 12, 2015
src Support for all subclasses of ReadablePartial and their Properties May 7, 2009
.gitignore Modernized build tools and scala versions Feb 12, 2015
LICENSE
README New features suggested by Bradford Apr 29, 2009
build.sbt bumped version to 0.8 Aug 21, 2015
sbt

README

A Scala wrapper for Joda Time

USAGE:

  import org.scala_tools.time.Imports._

  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

  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 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:
http://joda-time.sourceforge.net/index.html


MOTIVATION:

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.