I just announced the new Spring 5 modules in REST With Spring:


1. Overview

In this tutorial, we’ll explore several ways to convert String objects into Date objects. We’ll start with the new Date Time API – java.time that was introduced in Java 8 before looking at the old java.util.Date data type also used for representing dates.

To finish, we’ll also look at some external libraries for conversion using Joda-Time and the Apache Commons Lang DateUtils class.

2. Converting String to LocalDate or LocalDateTime

LocalDate and LocalDateTime are immutable date-time objects that represent a date and latterly a date and time. By default, Java dates are in the ISO-8601 format, so if we have any string which represents a date and time in this format, then we can use the parse() API of these classes directly.

Here‘s a bit more detail on this new API.

2.1. Using the Parse API

The Date-Time API provide parse() methods for parsing a String that contains date and time information. To convert String objects to LocalDate and LocalDateTime objects, the String must represent a valid date or time according to ISO_LOCAL_DATE or ISO_LOCAL_DATE_TIME.

Otherwise, a DateTimeParseException will be thrown at runtime.

In our first example, let’s convert a String to a java.time.LocalDate:

LocalDate date = LocalDate.parse("2018-05-05");

A similar approach to the above can be used to convert a String to a java.time.LocalDateTime:

LocalDateTime dateTime = LocalDateTime.parse("2018-05-05T11:50:55");

It is important to note that both the LocalDate and LocalDateTime objects are timezone agnostic. However, when we need to deal with time zone specific date and times we can use the ZonedDateTime parse method directly to get a time zone specific date time:

ZonedDateTime zonedDateTime = ZonedDateTime.parse("2015-05-05T10:15:30+01:00[Europe/Paris]");

Now let’s have a look at how we convert strings with a custom format.

2.2. Using the Parse API with a Custom Formatter

Converting a String with a custom date format into a Date object is a widespread operation in Java.

For this purpose, we’ll use the DateTimeFormatter class which provides numerous predefined formatters, and allows us to define a formatter.

Let’s start with an example of using one of the predefined formatters of DateTimeFormatter:

String dateInString = "19590709";
LocalDate date = LocalDate.parse(dateInString, DateTimeFormatter.BASIC_ISO_DATE);

In the next example let’s create a formatter that applies a format of “EEE, MMM d yyyy”. This format specifies three characters for the full day name of the week,  one digit to represent the day of the month, three characters to represent the month and four digits to represent the year.

This formatter recognizes strings such as “Fri,  3 Jan 2003″ or “Wed, 23 Mar 1994“:

String dateInString = "Mon, 05 May 1980";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("EEE, d MMM yyyy", Locale.ENGLISH);
LocalDate dateTime = LocalDate.parse(dateInString, formatter);

2.3. Common Date and Time Patterns

Let’s look at some common date and time patterns:

  • y – Year (1996; 96)
  • M – Month in year (July; Jul; 07)
  • d – Day in month (1-31)
  • E – Day name in week (Friday, Sunday)
  • a Am/pm marker (AM, PM)
  • H – Hour in day (0-23)
  • h – Hour in am/pm (1-12)
  • m – Minute in hour (0-60)
  • s – Second in minute (0-60)

For a full list of symbols that we can use to specify a pattern for parsing click here.

If we need to convert java.time dates into the older java.util.Date object, read this article for more details.

3. Converting String to java.util.Date

Before Java 8, the Java date and time mechanism was provided by the old APIs of java.util.Date, java.util.Calendar, and java.util.TimeZone classes which sometimes we still need to work with.

Let’s see how to convert a String into a java.util.Date object:

SimpleDateFormat formatter = new SimpleDateFormat("dd-MMM-yyyy", Locale.ENGLISH);

String dateInString = "7-Jun-2013";
Date date = formatter.parse(dateInString);

In the above example, we first need to construct a SimpleDateFormat object by passing the pattern describing the date and time format.

Next, we need to invoke the parse() method passing the date String. If the String argument passed is not in the same format as the pattern then a ParseException will be thrown.

3.1. Adding Time Zone Information to java.util.Date

It’s important to note that the java.util.Date has no concept of time zone, and only represents the number of seconds passed since the Unix epoch time – 1970-01-01T00:00:00Z.

But, when we print the Date object directly, it will always be printed with the Java default system time zone.

In this final example we’ll look at how to format a date, adding time zone information:

SimpleDateFormat formatter = new SimpleDateFormat("dd-M-yyyy hh:mm:ss a", Locale.ENGLISH);

String dateInString = "22-01-2015 10:15:55 AM"; 
Date date = formatter.parse(dateInString);
String formattedDateString = formatter.format(date);

We can also change the JVM time zone programmatically, but this isn’t recommended:


4. External Libraries

Now that we have a good understanding of how to convert String objects to Date objects using the new and old APIs offered by core Java let’s take a look at some external libraries.

4.1. Joda-Time Library

An alternative to the core Java Date and Time library is Joda-Time. Although the authors now recommend users to migrate to java.time (JSR-310) if this isn’t possible then the Joda-Time library provides an excellent alternative for working with Date and Time. This library provides pretty much all capabilities supported in the Java 8 Date Time project.

The artifact can be found on Maven Central:


Here’s a quick example working with the standard DateTime:

DateTimeFormatter formatter = DateTimeFormat.forPattern("dd/MM/yyyy HH:mm:ss");

String dateInString = "07/06/2013 10:11:59";
DateTime dateTime = DateTime.parse(dateInString, formatter);

Let’s also see an example of explicitly setting a time zone:

DateTimeFormatter formatter = DateTimeFormat.forPattern("dd/MM/yyyy HH:mm:ss");

String dateInString = "07/06/2013 10:11:59";
DateTime dateTime = DateTime.parse(dateInString, formatter);
DateTime dateTimeWithZone = dateTime.withZone(DateTimeZone.forID("Asia/Kolkata"));

4.2. Apache Commons Lang – DateUtils

The DateUtils class provides many useful utilities making it easier to work with the legacy Calendar and Date objects.

The commons-lang3 artifact is available from Maven Central:


Let’s convert a date String using an Array of date patterns into a java.util.Date:

String dateInString = "07/06-2013";
Date date = DateUtils.parseDate(dateInString, 
  new String[] { "yyyy-MM-dd HH:mm:ss", "dd/MM-yyyy" });

5. Conclusion

In this article, we illustrated several ways of converting Strings to different types of Date objects (with and without time), both in plain Java as well as using external libraries.

The full source code of the article is available over on GitHub.

I just announced the new Spring 5 modules in REST With Spring:


Leave a Reply

Notify of