Overview

Joda-Time
is a popular open source API for date and time manipulation.

Joda-Time is intuitive to use and is very elegantly designed. It has maps closely to the date-time domain concepts and has supports immutability. It has a wide variety of formatters which are thread safe. Support for TimeZones and multiple calendar systems is also provided.

Joda-Time API was a key driver in designing the
JSR 310
specification.

This is a How-To Guide for using the common features in Joda-Time API. Working code along with the expected output is described for each How-To.

The libraries used in the following examples are:

• joda-time-2.3.jar
• joda-convert-1.5.jar

The above libraries can be downloaded from Joda-Time
download page

Date-Time Key Concepts

1. Date Concepts
1. Calendar
2. Date
3. Day
4. Year
5. Week
6. Century Of Era
7. Era
8. Epoch
2. Time Concepts
1. TimeZone
2. UTC Offset
3. Clock Convention
4. Hour Of Day
5. Minute
6. Second
7. Milli-Second
3. Joda-Time Specific Concepts

Using DateTime

4. Instantiate DateTime
5. Get DateTime for current instant
6. Get sub-elements of DateTime (e.g. year, month, hours, etc.)
7. Perform arithmetic operations on DateTime like addition and substraction
8. Update sub-elements of DateTime
9. Get DateTime from String representation
10. Compare two DateTime instances
11. Convert DateTime to other representations like Milliseconds, JDK date, MutableDateTime, LocalDateTime and String
12. Handling DateTime Exceptions

Using DateTimeComparator

13. Compare DateTime
14. Compare Two DateTime instances considering only Date fields and ignoring TIme fields
15. Compare Two DateTime instances considering only Time fields and ignoring Date fields
16. Using Upper and Lower Limits for DateTime comparison

Using DateTimeFormat

17. Formatting Year Field
18. Formatting Month Field
19. Formatting Day Field
20. Formatting Day Of Week Field
21. Formatting Time Fields
22. Using Formatting Styles: Short, Medium, Long, Full and Omit
23. Define Styles Using Convenience Methods
24. Custom Formatting of Date and Time Using DateTimeFormatterBuilder

Using DateTimeZone

25. Constructing DateTimeZone
26. Get DateTimeZone Fields

Using Duration

27. Create Duration
28. Perform Arithmetic Operations On Duration
29. Convert Duration To Single Fields Periods like Days, Hours, Minutes and Seconds

Using Instant

30. Creating Instant
31. Comparing Two Instants
32. Get Sub-Fields of Instant
33. Perform Arithmentic Operations On Instant like Addition, Subtraction and Repeated Addition
34. Convert Instant To Other Representations Like DateTime, MutableDateTime,JDK Date and String

Using Interval

35. Construct An Interval
36. Find Relationship Between Two Intervals (Gap, Adjoining, Overlap)
37. Modify Interval Using Millis, Duration and Instant

Using Single Field Periods

38. Calculate Number Of Days
39. Perform Arithmetic Operations On Single Field Periods
40. Parsing ISO 8601 Format String For Period
41. Convert To Other Standard Representations Like Duration, Hour, Minute And Second

Using MutableDateTime

42. Modify Fields
43. Add Fields To MutableDateTime
44. Perform Rounding Operations

Using MutableInterval

45. Modify Interval

Using MutablePeriod

46. Modify Period

Miscellaneous Topics

47. Convert 2 Digit Year To 4 Digit Year Using Pivot Year
48. Get List Of Default Time Zones
49. Verify Whether A Partial DateTime Is Contiguous

To start, click on the next arrow. If you find anything missing in the tutorials then please drop in your comments.