Java Date Time Tutorials


A collection of Java date and time examples.

1. Java Date Time APIs

In old days, we use the following classic Date and Calendar APIs to represent and manipulate date.

  • java.util.Date – date and time, print with default time-zone.
  • java.util.Calendar – date and time, more methods to manipulate date.
  • java.text.SimpleDateFormat – formatting (date -> text), parsing (text -> date) for date and calendar.

In Java 8, a new series of date and time APIs (JSR310 and inspired by Joda-time) are created in the new java.time package.

  • java.time.LocalDate – date without time, no time-zone.
  • java.time.LocalTime – time without date, no time-zone.
  • java.time.LocalDateTime – date and time, no time-zone.
  • java.time.ZonedDateTime – date and time, with time-zone.
  • java.time.DateTimeFormatter – formatting (date -> text), parsing (text -> date) for java.time
  • java.time.Instant – date and time for machine, seconds passed since the Unix epoch time (midnight of January 1, 1970 UTC)
  • java.time.Duration – Measures time in seconds and nanoseconds.
  • java.time.Period – Measures time in years, months and days.
  • java.time.TemporalAdjuster – Adjust date.
Read Oracle article – Why do we need a new date and time library?

2. Java Date and Time Examples

List of the tutorials and updated with the new Java 8 java.time examples.

  1. Java Date and Calendar examples
  2. Java – How to compare dates
  3. Java – How to get current date time
  4. Java – How to get current timestamp
  5. Java – How to convert String to a Date
  6. Java – How to calculate elapsed time
  7. Java 8 – How to convert String to LocalDate
  8. Java 8 – How to format LocalDateTime
  9. Java 8 – Convert Instant to LocalDateTime
  10. Java 8 – Convert Instant to ZoneDateTime
  11. Java 8 – Convert Date to LocalDate and LocalDateTime
  12. Java 8 – ZonedDateTime examples
  13. Java – Convert date and time between timezone
  14. Java – Display all ZoneId and its UTC offset
  15. Java 8 – Duration and Period examples
  16. Java – How to add days to current date
  17. Java 8 – TemporalAdjusters examples
  18. Java 8 – MinguoDate examples (Taiwan calendar)
  19. Java 8 – HijrahDate, How to calculate the Ramadan date (Islamic calendar)


  1. Read Oracle article – Why do we need a new date and time library?
  2. Joda Time
  3. JSR 310: Date and Time API
  4. SimpleDateFormat JavaDoc
  5. DateTimeFormatter JavaDoc
  6. java.util.Date JavaDoc
  7. java.util.Calendar JavaDoc
  8. Read this – Java Date vs Calendar

About the Author

author image
Founder of, love Java and open source stuff. Follow him on Twitter, or befriend him on Facebook or Google Plus. If you like my tutorials, consider make a donation to these charities.


1 Comment threads
0 Thread replies
Most reacted comment
Hottest comment thread
1 Comment authors
Santhosh Recent comment authors
newest oldest most voted

How to display the date format in lastmonth-currentmonth-nextmonth? and also this format needs to be iterated based on the month selected.