What is the difference between android.text.format.DateFormat and java.text.DateFormat

As far as I can tell, android.text.format.DateFormat has some of the functionality from java.text.DateFormat, some of the functionality from java.text.SimpleDateFormat, and some extra functionality of its own.

Most notably:

• The java SimpleDateFormat allows construction of arbitrary non-localized formats.
• The java DateFormat allows construction of three localized formats each for dates and times, via its factory methods.
• The android DateFormat allows most of the above (arbitrary formats and a smaller number of localized formats), but also provides getBestDateTimePattern which picks a locale-appropriate format string that contains the elements specified with locale-appropriate ordering and punctuation.

So, if you need a localized date/time format other than the three provided by java's DateFormat class, the android DateFormat class is the solution.

Less importantly, but an additional convenience: the android DateFormat methods can take a Calendar or long milliseconds directly, instead of requiring a Date object. I always prefer working with Calendar or long over Date. Also, it properly respects the timezone of the Calendar object -- whereas getting a Date from a Calendar and passing that along to the formatter loses the timezone information. (Nothing you can't get around via java DateFormat's setCalendar method, but it's nice to not have to.)

Finally, and least importantly, some of the methods of the Android DateFormat don't actually construct a formatter, you just construct a format string. All of this class's methods are static. The methods do that construct a DateFormat actually construct a java DateFormat!

How about some self-help here? Compare the APIs, read the JavaDocs and see for yourself:

• java.text.DateFormat
• android.text.format.DateFormat