Max asked for the pros and cons of using Joda...

Pros:

• It works, very well. I strongly suspect there are far fewer bugs in Joda than the standard Java libraries. Some of the bugs in the Java libraries are really hard (if not impossible) to fix due to the design.
• It's designed to encourage you to think about date/time handling in the right way - separating the concept of a "local time" (e.g "wake me at 7am wherever I am") and an instant in time ("I'm calling James at 3pm PST; it may not be 3pm where he is, but it's the same instant")
• I believe it makes it easier to update the timezone database, which does change relatively frequently
• It has a good immutability story, which makes life a lot easier IME.
• Leading on from immutability, all the formatters are thread-safe, which is great because you almost always want to reuse a single formatter through the application
• If/when Java 7 gains a similar library, you'll have a head-start on learning it, as it'll be similar

Cons:

• It's another API to learn (although the docs are pretty good)
• It's another library to build against and deploy
• If/when Java 7 gains a similar library, you'll need to relearn some stuff
• I've failed to use the DateTimeZoneBuilder effectively in the past. This is a very rare use case though.

To respond to the oxbow_lakes' idea of effectively building your own small API, here are my views of why this is a bad idea:

• It's work. Why do work when it's already been done for you?
• A newcomer to your team is much more likely to be familiar with Joda than with your homegrown API
• You're likely to get it wrong for anything beyond the simplest uses... and even if you initially think you only need simple functionality, these things have a habit of growing more complicated, one tiny bit at a time. Date and time manipulation is hard to do properly. Furthermore, the built-in Java APIs are hard to use properly - just look at the rules for how the calendar API's date/time arithmetic works. Building anything on top of these is a bad idea rather than using a well-designed library to start with.

• Date and Time helper for PHP (like Joda-Time in Java)

  I am looking for a library (open source) like Joda-Time in the Java world. Is there any library like that? Joda-Time is very helpful to calculate date and time. I can add days, weeks, month, year…

• How can I get the difference in days between a java.util.Date and a Joda-Time DateTime?

  class ReminderInterval{ Date lastDate=Obj.getAccepted(); //it will return a last login date(java.util.Date). DateTime currentDate=new DateTime(); //it is Joda-Time type } Is it possible t…

• Java Joda Time - Implement a Date range iterator

  I'm trying to implement without success a Date iterator with Joda time. I need something that allows me to iterate all the days form startDate to endDate Do you have any idea on how to do that?

• Parsing date with Joda with time zone

  I have two timestamps which describe the same instant of time in two different formats. 2010-10-03 18:58:07 and 2010-10-03T16:58:07.000+02:00 . I parse the timestamps with two different date f…

• How to convert a java Date to a ReadableInstant for Joda Time inside a JSP?

  I instantiated a java.util.Date object called myDate in my controller and passed it to my JSP where I have a Joda Time JSP tag configured with this at the top of the page: <%@taglib prefix="jo…

• Joda Time bug or my mistake? (Java Joda Time dates as strings parsing)

  so I was having a problem parsing a date, using the JodaTime chronology IslamicChronology so wrote a small example to demonstrate my problem. Here's the code: import org.joda.time.Chronology; …

• Does a library exist with Joda Time / iBATIS integration classes?

  It looks like I have to implement com.ibatis.sqlmap.client.extensions.TypeHandlerCallback for both DateTime and LocalDateTime Joda types. This isn't a big deal, but if it's implemented somewhere els…

• Parsing time strings like "1h 30min"

  Anyone know of a Java library that can parse time strings such as "30min" or "2h 15min" or "2d 15h 30min" as milliseconds (or some kind of Duration object). Can Joda-Time do something like this? …

• Problem converting java.util.Date to org.joda.time.LocalDateTime

  import org.joda.time.LocalDateTime; import java.util.Date; With this date or with the following ones it's all OK: new LocalDateTime(new Date(0,0,1,2,30)) — 1900-01-01T02:30:00.000 new Loc…

• Approximate Time Period with Joda-Time

  I am using Joda library to get time period passed since a given timestamp: public static String getTimePassedSince(Date initialTimestamp){ DateTime initDT = new DateTime(initialTimestamp.get…