Skip to content

ubourdon/scala-time

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

A Scala wrapper for Joda Time

Resources

License

Stars

Watchers

Forks

Packages

No packages published