8

I am trying to parse a String using SimpleDateFormat.

This is my current code:

public String getCreatedDateTime() {
    SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-ddEHH:mm:ss.zzzz");
    try {
        Date date = simpleDateFormat.parse("2015-06-27T13:16:37.363Z");
        return date.toString();
    } catch (ParseException e) {
        return "Error parsing date";
    }
}

As you can see, I just put a constant in the parse() method for testing purposes.

So, this is what I am trying to parse:

2015-06-27T13:16:37.363Z

This is the SimpleDateFormat pattern that I am using:

yyyy-MM-ddEHH:mm:ss.zzzz

I keep getting the ParseException.

I know that it is proably because of the .zzzz at the end but I have no idea what .363Z might stand for so I just used some random letters. Bad idea.

I'll appreciate your help a lot. Thank you!

Basil Bourque
  • 303,325
  • 100
  • 852
  • 1,154
Guy
  • 6,414
  • 19
  • 66
  • 136
  • 1
    I recommend you throw away the long outmoded and notoriously troublesome `SimpleDateFormat` and friends and use [`java.time`, the modern Java date and time API,](https://docs.oracle.com/javase/tutorial/datetime/) instead. It is so much nicer to work with. – Ole V.V. Jan 25 '18 at 08:10

2 Answers2

14

Try with this pattern (note the X at the end and the 'T' in the middle):

"yyyy-MM-dd'T'HH:mm:ss.SSSX"

From Java's SimpleDateFormat's documentation:

ISO 8601 Time zone:

...

For parsing, "Z" is parsed as the UTC time zone designator.

And, from the part where it describes the different characters:

X - Time zone - ISO 8601 time zone

EDIT

If using Android, then "X" is not supported.

You can use this pattern (note Z is a literal now):

"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"

But then you'll get the date on your current timezone and would need to convert it to UTC if needed.

Community
  • 1
  • 1
eugenioy
  • 11,825
  • 28
  • 35
  • 1
    Thank you for your answer. It sadly doesn't work yet. I get *IllegalArgumentException: Unknown pattern character X* with your pattern. Which is weird because X clearly is a pttern characters as seen from documentation. – Guy Jun 27 '15 at 16:57
  • Which version of Java are you using? And is it the Java SE or Android? – eugenioy Jun 27 '15 at 17:00
  • I'm using jdk1.8.0_40 and this is Android. – Guy Jun 27 '15 at 17:03
  • Well, it seems the "X" is not supported on Android. I'll update my answer and include a part for Android as well. – eugenioy Jun 27 '15 at 17:03
  • Awesome, this works now. Thank you very much! – Guy Jun 27 '15 at 17:09
  • 2
    You can set the timezone for parsing/formatting with simpleDateFormat.setTimeZone(TimeZone.getTimeZone("UTC")) to make your intent clear and avoid conversion after parsing. http://docs.oracle.com/javase/7/docs/api/java/text/DateFormat.html#setTimeZone(java.util.TimeZone) – Alain O'Dea Jun 27 '15 at 17:23
  • @AlainO'Dea your comment solved even one more problem that I've had. Thank you very much. – Guy Jun 27 '15 at 22:10
  • @Whiz my pleasure. I was hoping it might. That one line was the solution to many confusing bugs for me. I've seen it time and again. There's a bug that this fixes in OneLogin's SAML library. https://github.com/onelogin/java-saml/blob/master/src/main/java/com/onelogin/saml/AuthRequest.java#L36-37. I meant to do a Pull Request, but forgot since I switched to OpenSAML instead. – Alain O'Dea Jun 28 '15 at 01:08
  • **Never put quote marks around the `Z`.** Doing so is an instruction to treat the letter an a mere literal. You would be discarding valuable information, as `Z` means an offset from UTC of zero hours-minutes-seconds. – Basil Bourque Aug 29 '22 at 06:42
11

tl;dr

Skip the formatting pattern. Standard ISO 8601 format is used by default.

Instant.parse( "2015-06-27T13:16:37.363Z" )

ISO 8601

Your string format is formally defined by the ISO 8601 standard.

Basically your Question is a duplicate of this one, Converting ISO 8601-compliant String to java.util.Date.

Alternatives

The Answer by eugenioy is correct.

But you should know that the old java.util.Date/.Calendar/java.text.SimpleDateFormat classes bundled with Java are notoriously troublesome and should be avoided.

Outmoded Classes

Those old classes are now outmoded, first by the third-party Joda-Time library, and now by the new java.time package (Tutorial) built into Java 8 and later (inspired by Joda-Time, defined by JSR 310, extended by the ThreeTen-Extra project).

Both java.time and Joda-Time use the ISO 8601 standard as their defaults when parsing/generating string representations of date-time values. So the code is simple, no need for custom formatter objects. No need for all that format twiddling that caused your Exception.

Time Zone

Both java.time and Joda-Time have a zoned date-time class that understands its assigned time zone (unlike java.util.Date). If you do not assign one, the JVM’s current default time zone is assigned.

Beware that the JVM’s current default time zone can change at any time. It can change at deployment, defaulting to whatever the host OS setting is. And it can change at any moment during runtime when any code in any thread of any app within the JVM calls TimeZone.setDefault. So better to explicitly assign a desired/expected time zone.

java.time

The Z on the end of your string is short for Zulu and means UTC. The Instant class can directly parse that format, to represent a moment on the timeline in UTC with a resolution in nanoseconds.

String input = "2015-06-27T13:16:37.363Z";
Instant instant = Instant.parse( input );

Change the time zone from UTC to some desired/expected time zone.

ZoneID zone = ZoneId.of( "America/Montreal" ) ;
ZonedDateTime zdtMontréal = instant.atZone( zone ) ;

If you really need a java.util.Date for interoperability, convert.

java.util.Date utilDate = Date.from( zdtMontréal.toInstant() ) ;

Joda-Time

The Joda-Time project is now in maintenance mode, with the team advising migration to the java.time classes:

Note that from Java SE 8 onwards, users are asked to migrate to java.time (JSR-310) - a core part of the JDK which replaces this project.

Example code using Joda-Time 2.8.1.

String input = "2015-06-27T13:16:37.363Z" ;
DateTimeZone zone = DateTimeZone.UTC ;  //  Or: DateTimeZone.forID( "America/Montreal" ) ;
DateTime dateTime = new DateTime( input, zone ) ;

If you really need a java.util.Date for interoperability, convert.

java.util.Date date = dateTime.toDate();

About java.time

The java.time framework is built into Java 8 and later. These classes supplant the troublesome old legacy date-time classes such as java.util.Date, Calendar, & SimpleDateFormat.

To learn more, see the Oracle Tutorial. And search Stack Overflow for many examples and explanations. Specification is JSR 310.

The Joda-Time project, now in maintenance mode, advises migration to the java.time classes.

You may exchange java.time objects directly with your database. Use a JDBC driver compliant with JDBC 4.2 or later. No need for strings, no need for java.sql.* classes.

Where to obtain the java.time classes?

The ThreeTen-Extra project extends java.time with additional classes. This project is a proving ground for possible future additions to java.time. You may find some useful classes here such as Interval, YearWeek, YearQuarter, and more.

Basil Bourque
  • 303,325
  • 100
  • 852
  • 1,154