420

What is the most elegant way to get ISO 8601 formatted presentation of the current moment, UTC? It should look like: 2010-10-12T08:50Z.

Example:

String d = DateFormat.getDateTimeInstance(DateFormat.ISO_8601).format(date);
4

24 Answers 24

358

Use SimpleDateFormat to format any Date object you want:

TimeZone tz = TimeZone.getTimeZone("UTC");
DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm'Z'"); // Quoted "Z" to indicate UTC, no timezone offset
df.setTimeZone(tz);
String nowAsISO = df.format(new Date());

Using a new Date() as shown above will format the current time.

14
  • 8
    @Joachim The negative side of this "standard" approach is that I have to have many instances of "yyyy-MM-dd'T'HH:mmZ" in my application, every time I need an ISO-8601 formatted date. With JodaTime, as I see, I can use a pre-defined formatter ISODateTimeFormat, which does this job for me..
    – yegor256
    Commented Oct 12, 2010 at 12:18
  • 10
    @Joachim, Z is valid pattern in SimpleDateFormat, rather do this: yyyy-MM-dd'T'HH:mm'Z'. Commented Oct 12, 2010 at 12:43
  • 35
    -1 This gives you the date/time in the current timezone - not UTC. Carlos' answer includes the necessary UTC code. Commented Mar 30, 2012 at 16:15
  • 21
    I just fixed the timezone mistake - since it is the accepted answer I think it was the right thing to do.
    – BoD
    Commented Aug 16, 2013 at 22:22
  • 2
    The Z needs to be quoted like "yyyy-MM-dd'T'HH:mm'Z'" Commented Oct 13, 2015 at 22:26
268

Java 8 Native

java.time makes it simple since Java 8. And thread safe.

ZonedDateTime.now( ZoneOffset.UTC ).format( DateTimeFormatter.ISO_INSTANT )

Result: 2015-04-14T11:07:36.639Z

You may be tempted to use lighter Temporal such as Instant or LocalDateTime, but they lacks formatter support or time zone data. Only ZonedDateTime works out of the box.

By tuning or chaining the options / operations of ZonedDateTime and DateTimeFormatter, you can easily control the timezone and precision, to a certain degree:

ZonedDateTime.now( ZoneId.of( "Europe/Paris" ) )
             .truncatedTo( ChronoUnit.MINUTES )
             .format( DateTimeFormatter.ISO_DATE_TIME )

Result: 2015-04-14T11:07:00+01:00[Europe/Paris]

Refined requirements, such as removing the seconds part, must still be served by custom formats or custom post process.

.format( DateTimeFormatter.ISO_LOCAL_DATE_TIME ) // 2015-04-14T11:07:00
.format( DateTimeFormatter.ISO_LOCAL_DATE ) // 2015-04-14
.format( DateTimeFormatter.ISO_LOCAL_TIME ) // 11:07:00
.format( DateTimeFormatter.ofPattern( "yyyy-MM-dd HH:mm" ) ) // 2015-04-14 11:07

For Java 6 & 7, you may consider back-ports of java.time such as ThreeTen-Backport, which also has an Android port. Both are lighter than Joda, and has learned from Joda's experience - esp. considering that java.time is designed by Joda's author.

5
  • 12
    Good answer. Notice the good habit of explicitly specifying a time zone rather than relying implicitly on the JVM’s current default time zone. You may specify a particular time zone if desired, such as ZoneId.of( "America/Montreal" ). Commented Feb 17, 2016 at 21:51
  • 3
    Instant allows to format it in ISO 8601 format by just calling .toString() method: return DateTimeFormatter.ISO_INSTANT.format(this);
    – VadymVL
    Commented Nov 7, 2017 at 14:39
  • This is best because you avoid the default. Commented Apr 3, 2018 at 12:18
  • 10
    Warning: The solution for Java 8 using ISO_INSTANT has an annoying quirk. When the milliseconds happen to be 0 they are not included in the output. This is allowed according to the ISO 8601 standard but many libraries and parsers in other languages are not that forgiving. If it is necessary to always include the zeros use this instead: DateTimeFormatter ISO_8601 = ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSSX").withZone(UTC);
    – jurgen
    Commented Jul 24, 2018 at 20:57
  • 2
    After switching from Java 8 to 11, I see DateTimeFormatter.ISO_INSTANT and DateTimeFormatter.ISO_DATE_TIME using 6 digits after the seconds, as opposed to 3, which is no longer picked up by Spring's @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME).
    – DanielM
    Commented Jan 23, 2020 at 11:29
233

For systems where the default Time Zone is not UTC:

TimeZone tz = TimeZone.getTimeZone("UTC");
DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm'Z'");
df.setTimeZone(tz);
String nowAsISO = df.format(new Date());

The SimpleDateFormat instance may be declared as a global constant if needed frequently, but beware that this class is not thread-safe. It must be synchronized if accessed concurrently by multiple threads.

EDIT: I would prefer Joda Time if doing many different Times/Date manipulations...
EDIT2: corrected: setTimeZone does not accept a String (corrected by Paul)

7
  • 20
    This format isn't a constant anywhere in some built in library? Commented Jun 10, 2014 at 22:44
  • 1
    There are two different packages for 'DateFormat', remember to use 'import java.text.DateFormat'
    – dev4life
    Commented Jun 24, 2014 at 19:12
  • 3
    If you want the current time zone use TimeZone tz = TimeZone.getDefault(); instead
    – dev4life
    Commented Jun 24, 2014 at 19:15
  • You should not quote the 'Z' in the format since that makes it logically insignificant. If the TimeZone is UTC as in the example above then an unquoted Z will only result in a Z in the output...however if the TimeZone is not UTC then the Z will still be output as a literal implying UTC when the time may not be. If a consuming system reads the Z as UTC but the time is not the time will be shifted. Conversely if a parser uses the quoted Z without setting the TimeZone it will parse UTC times as local times (again shifting). This quote isn't needed if the TZ is set but is dangerous if it isn't. Commented Jun 13, 2016 at 18:50
  • @MattWhipple - but if you use an unquoted Z the result will be something like 2016-06-14T13:56+0000 - the question is asking for something like 2016-06-14T13:56Z
    – user85421
    Commented Jun 14, 2016 at 14:00
217

As of Java 8 you can simply do:

Instant.now().toString();

From the java.time.Instant docs:

now

public static Instant now()

Obtains the current instant from the system clock.

This will query the system UTC clock to obtain the current instant.

 

toString

public String toString()

A string representation of this instant using ISO-8601 representation.

The format used is the same as DateTimeFormatter.ISO_INSTANT.

6
  • 26
    This is the right answer, and it's a scandal that it hasn't been upvoted higher over all these concocted SimpleDateFormats. Commented May 7, 2018 at 15:27
  • Glad I read more answers. I agree, this should be the answer now. Commented Jan 27, 2020 at 16:01
  • And because it's toString, in many cases you won't even need to call it explicitly.
    – kaya3
    Commented Feb 25, 2020 at 22:49
  • 1
    Warning in a comment on a previous answer applies here too: "Warning: The solution for Java 8 using ISO_INSTANT has an annoying quirk. When the milliseconds happen to be 0 they are not included in the output. This is allowed according to the ISO 8601 standard but many libraries and parsers in other languages are not that forgiving."
    – David L
    Commented Feb 26, 2020 at 20:09
  • i would like to add that Date has a .toInstant() so something like: final Date expirationTime = new Date(System.currentTimeMillis() + SecurityConstants.EXPIRATION_TIME); expirationTime.toInstant().toString() //outputs "2022-02-21T17:19:54.667Z"
    – Paolo
    Commented Feb 11, 2022 at 17:20
132

Java 8:

thisMoment = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mmX")
                              .withZone(ZoneOffset.UTC)
                              .format(Instant.now());

Pre Java 8:

thisMoment = String.format("%tFT%<tRZ",
                           Calendar.getInstance(TimeZone.getTimeZone("Z")));

From the docs:

'R'    Time formatted for the 24-hour clock as "%tH:%tM"
'F'    ISO 8601 complete date formatted as "%tY-%tm-%td".

9
  • 26
    Well, either you include an extra third-party library as a dependency to your project (which you may want to keep up to date, and ship with your application, hey, it's just an extra 3.2 megabytes) and do DateTime dt = new DateTime(); DateTimeFormatter fmt = ISODateTimeFormat.dateTime(); String str = fmt.print(dt);, or you do encapsulate return String.format("%tFT%<tRZ", new Date()); into a class, and do str = Iso8601Time.now(), where ever you need it. (It's not like the ISO format is going to change.) If it turns out that you need more than just current date in ISO format, use a lib.
    – aioobe
    Commented Oct 12, 2010 at 12:36
  • 11
    %tFT%<tTZ will include seconds; %tFT%<tTZ.%<tL will include milliseconds. Commented Aug 5, 2012 at 1:21
  • 3
    A very neat solution, should be the accepted answer by now :)
    – AbdelHady
    Commented Aug 21, 2014 at 16:28
  • 4
    @PatrickLinskey has a helpful comment for adding the seconds and milliseconds to the output, but the pattern for milliseconds has a small error. The Z should appear after the milliseconds like this %tFT%<tT.%<tLZ
    – sho222
    Commented Oct 3, 2014 at 20:55
  • 2
    DateTimeFormatter has the constant ISO_DATE_TIME to get an ISO-8601 date formatter, instead of explicitly writing the pattern yourself.
    – nickb
    Commented Jan 2, 2017 at 20:45
32

use JodaTime

The ISO 8601 calendar system is the default implementation within Joda-Time

Here is the doc for JodaTime Formatter

Edit:

If you don't want to add or if you don't see value of adding above library you could just use in built SimpleDateFormat class to format the Date to required ISO format

as suggested by @Joachim Sauer

DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mmZ");
String nowAsString = df.format(new Date());
7
  • 3
    And how would you produce a String formated as shown in the question? Commented Oct 12, 2010 at 12:12
  • 4
    I'd say don't add a library-dependency for something as simple as this (which can be achieved with two lines of java-code). (Sure, if the requirements grows, it's another story.)
    – aioobe
    Commented Oct 12, 2010 at 12:14
  • 1
    @aioobe , if its just used in several part of app then its ok to go for default, in rest case jodatime is better. Commented Oct 12, 2010 at 12:15
  • 5
    @aioobe jodatime is better in any case, because it has ISODateTimeFormat -- a predefined formatter of ISO-8601.
    – yegor256
    Commented Oct 12, 2010 at 12:19
  • 3
    @org.life.java: which are only relevant when you can switch to Jode time properly. You won't have them, when you use only this function of Joda time. Commented Oct 12, 2010 at 13:29
22

DateFormatUtils from Apache commons-lang3 have useful constants, for example: DateFormatUtils.ISO_DATETIME_FORMAT

1
  • 5
    More accurately, the current moment in UTC: DateFormatUtils.format(new Date(), "yyyy-MM-dd'T'HH:mm'Z'", TimeZone.getTimeZone("UTC")); current moment in default time zone: DateFormatUtils.ISO_DATETIME_TIME_ZONE_FORMAT.format(new Date()); @yegor256 thanks for mentioning DateFormatUtils, having on board apache commons-lang it's worth to use the date format.
    – babinik
    Commented Sep 18, 2013 at 13:40
19

If you don't want to include Jodatime (as nice as it is)

javax.xml.bind.DatatypeConverter.printDateTime(
    Calendar.getInstance(TimeZone.getTimeZone("UTC"))
);

which returns a string of:

2012-07-10T16:02:48.440Z

which is slightly different to the original request but is still ISO-8601.

16

ISO 8601 may contains seconds see http://en.wikipedia.org/wiki/ISO_8601#Times

so the code should be

DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'");
15

tl;dr

Some of the other Answers are correct in recommending java.time classes but go about using unnecessary lengths for your specific needs.

Instant.now()                               // Capture the current moment in UTC with a resolution as fines nanoseconds but usually in microseconds or milliseconds.
       .truncatedTo( ChronoUnit.MINUTES )   // Lop off any seconds or fractional second, to get a value in whole minutes.
       .toString()                          // Generate a String in standard ISO 8601 format where a `T` separates the year-month-day from the hour-minute-second, and the `Z` on the end for “Zulu” means UTC.

2018-01-23T12:34Z

Instant::toString

The jav.time.Instant class represents a moment in UTC, always in UTC.

Instant instant = Instant.now() ;

instant.toString(): 2018-01-23T12:34:56.123456Z

The Z on the end of your example string 2010-10-12T08:50Z is pronounced “Zulu” and means UTC.

Your desired format happens to comply with the ISO 8601 standard. The java.time classes use these standard formats by default when parsing/generating strings. So no need to specify a formatting pattern. Just call Instant::toString as seen above.

If you specifically want whole minutes without second or fractional second, then truncate. Specify a unit of time via ChronoUnit class.

Instant instant = Instant.now().truncatedTo( ChronoUnit.MINUTES ) ;
String output = instant.toString();  // Generate a `String` object in standard ISO 8601 format.

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.

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

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

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.

13

Joda-Time

Update: The Joda-Time project is now in maintenance mode, with the team advising migration to the java.time classes. For Java 6 & 7, see the ThreeTen-Backport project, further adapted for Android in the ThreeTenABP project.

Using the Joda-Time library…

String output = new DateTime( DateTimeZone.UTC ).toString() ;

This is thread-safe. Joda-Time creates new immutable objects rather than changing existing objects.

If you truly intended to ask for a format without seconds, resolving to minutes, then use one of the many other built-in formatters in Joda-Time.

DateTime now = new DateTime( DateTimeZone.UTC ) ;
String output = ISODateTimeFormat.dateHourMinute.print( now ) ;

java.time

For Java 8 and later, Joda-Time continues to work. But the built-in java.time framework supplants Joda-Time. So migrate your code from Joda-Time to java.time as soon as is convenient.

See my other Answer for a modern solution.


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.

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

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

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.

0
7

For Java version 7

You can follow Oracle documentation: http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

X - is used for ISO 8601 time zone

TimeZone tz = TimeZone.getTimeZone("UTC");
DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX");
df.setTimeZone(tz);
String nowAsISO = df.format(new Date());

System.out.println(nowAsISO);

DateFormat df1 = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX");
//nowAsISO = "2013-05-31T00:00:00Z";
Date finalResult = df1.parse(nowAsISO);

System.out.println(finalResult);
6

I do believe the easiest way is to first go to instant and then to string like:

String d = new Date().toInstant().toString();

Which will result in:

2017-09-08T12:56:45.331Z

2
  • 4
    If you want the current time, there’s no need to go through an old-fashioned Date object. Just do Instant.now().toString(). If you got a Date from a legacy API, your method is the best one.
    – Anonymous
    Commented Nov 15, 2017 at 11:45
  • As Ole V.V. commented, the troublesome old date-time classes such as java.util.Date, java.util.Calendar, and java.text.SimpleDateFormat are now legacy, supplanted by the java.time classes built into Java 8 and later. See Tutorial by Oracle. Commented Apr 10, 2018 at 20:29
5

You could use Java's SimpleDateFormat with the following pattern yyyy-MM-dd'T'HH:mm:ssXXX for ISO 8601.

Sample Code: (lists out for all the available time zones)

for (String timeZone : TimeZone.getAvailableIDs())
{
    DateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssXXX");
    dateFormat.setTimeZone(TimeZone.getTimeZone(timeZone));
    String formatted = dateFormat.format(new Date());
    System.out.print(formatted);

    if (formatted.endsWith("Z"))
    {
        // These time zone's have offset of '0' from GMT.
        System.out.print("\t(" + timeZone + ")");
    }

    System.out.println();
}

You could use:

TimeZone.getDefault()

for the default vm timezone. More here

You might notice the date time for few time zones that end with 'Z'. These time zones have offset of '0' from GMT.

More info can be found here.

3
private static String getCurrentDateIso()
{
    // Returns the current date with the same format as Javascript's new Date().toJSON(), ISO 8601
    DateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", Locale.US);
    dateFormat.setTimeZone(TimeZone.getTimeZone("UTC"));
    return dateFormat.format(new Date());
}
2

Here's a whole class optimized so that invoking "now()" doesn't do anything more that it has to do.

public class Iso8601Util
{
    private static TimeZone tz = TimeZone.getTimeZone("UTC");
    private static DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm'Z'");

    static
    {
        df.setTimeZone(tz);
    }

    public static String now()
    {
        return df.format(new Date());
    }
}
4
  • 9
    Making it static may cause trouble as SimpleDateFormat is not thread safe: "Date formats are not synchronized. It is recommended to create separate format instances for each thread. If multiple threads access a format concurrently, it must be synchronized externally." docs.oracle.com/javase/7/docs/api/java/text/… Commented Feb 7, 2013 at 21:10
  • 2
    As @Juha Palomäki mentioned, this is not threadsafe. If you are using Java 8 or higher, ThreadLocal.withInitial can fix that. If you are using Java 7 or lower, create a new ThreadLocal and supply an initial value by overriding ThreadLocal.initialValue Commented Oct 16, 2014 at 15:43
  • @user393274 - if you are using Java 8 you should use Instant, DateTimeFormat and the other modern thread safe replacements
    – user177800
    Commented Sep 5, 2017 at 18:08
  • I'm a bit puzzled by what the problem is with SimpleDateFormat not being thread safe. If two threads execute the static initializer at the same time, I can't see anything worse happening than the SimpleDateFormat constructor gets called twice but only one instant of it (the last one to finish) gets recorded as "df". Commented Feb 7, 2018 at 3:09
2
DateTimeFormatter.ISO_DATE_TIME
        .withZone(ZoneOffset.UTC)
        .format(yourDateObject.toInstant())
1
  • While this code may answer the question, providing additional context regarding why and/or how this code answers the question improves its long-term value. Commented Apr 27, 2018 at 5:13
1

Still, joda-time does only support the extended format: "2015-12-09T00:22:42.930Z" not the basic: "20151209T002242.930Z" ...we might be better off testing a list of formats with java SimpleDateFormat.

1

I did it in Android using Calendar and SimpleDateFormat. The following method returns a Calendar with the "GMT" TimeZone (This is the universal time zone). Then you can use the Calendar class to set the hour between differents time zones, using the method setTimeZone() of the Calendar class.

private static final String GMT = "GMT";
private static final String DATE_FORMAT_ISO = "yyyyMMdd'T'HHmmss";

public static Calendar isoToCalendar(final String inputDate) {
    Calendar calendar = Calendar.getInstance(TimeZone.getTimeZone(GMT));
    try {
        SimpleDateFormat dateFormat = new SimpleDateFormat(DATE_FORMAT_ISO, Locale.US);
        dateFormat.setTimeZone(TimeZone.getTimeZone(GMT));
        Date date = dateFormat.parse(inputDate);
        calendar.setTime(date);
    } catch (ParseException e) {
        Log.e("TAG",e.getMessage());
    }
    return calendar;
}

REMEMBER: The Date class doesn't know about the TimeZone existence. By this reason, if you debug one date,you always see the date for your current timezone.

1

They should have added some kind of simple way to go from Date to Instant and also a method called toISO8601, which is what a lot of people are looking for. As a complement to other answers, from a java.util.Date to ISO 8601 format:

Instant.ofEpochMilli(date.getTime()).toString();

It is not really visible when using auto-completion but: java.time.Instant.toString():

A string representation of this instant using ISO-8601

1

If you care about performance, I created a library which outperforms standard Java parser and formatter in manipulating with ISO8601-formatted dates. DatetimeProcessor implementations are thread-safe and can be cached in a concurrent map or static fields.

<dependency>
  <groupId>com.axibase</groupId>
  <artifactId>date-processor</artifactId>
  <version>1.0.3</version>
</dependency>
import com.axibase.date.DatetimeProcessor;
import com.axibase.date.PatternResolver;
import org.junit.Before;
import org.junit.Test;

import java.time.Clock;
import java.time.Instant;
import java.time.ZoneId;
import java.time.ZoneOffset;

import static org.hamcrest.MatcherAssert.assertThat;
import static org.hamcrest.core.Is.is;

public class DateFormatTest {
    private Clock clock;

    @Before
    public void prepare() {
        clock = Clock.fixed(Instant.ofEpochMilli(1571285405300L), ZoneId.of("Europe/Berlin"));
    }

    @Test
    public void testIsoMillis(){
        final DatetimeProcessor formatter = PatternResolver.createNewFormatter("iso");
        assertThat(formatter.print(clock.millis(), ZoneOffset.UTC), is("2019-10-17T04:10:05.300Z"));
    }

    @Test
    public void testIsoMillisLocalZone(){
        final DatetimeProcessor formatter = PatternResolver.createNewFormatter("iso");
        assertThat(formatter.print(clock.millis(), clock.getZone()), is("2019-10-17T06:10:05.300+02:00"));
    }

    @Test
    public void testIsoMinutes(){
        final DatetimeProcessor formatter = PatternResolver.createNewFormatter("yyyy-MM-ddTHH:mmXXX");
        assertThat(formatter.print(clock.millis(), ZoneOffset.UTC), is("2019-10-17T04:10Z"));
    }
}

0

Java 8+

If you are still using SimpleDateFormat with new Instant API, it will not work. Use DateTimeFormatter instead.

Instant ts = Instant.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.000'Z'")
                .withZone(ZoneId.systemDefault());
String output = formatter.format(ts);
-1

For those using Joda Time, here's a one-liner in the format yyyy-MM-dd'T'HH:mm:ss'Z'

DateTime(timeInMillis, DateTimeZone.UTC).toString(ISODateTimeFormat.dateTimeNoMillis())
1
  • This solution eliminates the problem caused by multiple time zones. Commented Dec 30, 2021 at 21:49
-2

Try This,

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSSSSSZ");
        String date=sdf.format (new Date() );

Its For ISO 8601 format

1
  • 2
    This would use dates in the wrong time zone, see answer by Carlos. Commented Mar 25, 2013 at 15:31

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.