Class ISO8601


  • public class ISO8601
    extends Object
    This class provides utility methods for parsing and formatting ISO8601 formatted dates.
    • Constructor Detail

      • ISO8601

        public ISO8601()
    • Method Detail

      • getTimestamp

        public static String getTimestamp()
        Get a ISO8601 formatted string for the current date and time.
        Returns:
        a ISO8601 formatted string for the current date and time
      • getTimestamp

        public static String getTimestamp​(boolean withMsec)
        Get a ISO8601formatted string for the current date and time.
        Parameters:
        withMsec - flag indicating whether to include milliseconds
        Returns:
        a ISO8601 formatted string for the current date and time
      • toString

        public static String toString​(Calendar cal)
        Get a ISO8601 formatted string for the provided Calendar instance.
        Parameters:
        cal - the Calendar instance to get the ISO8601 formatted string for
        Returns:
        a ISO8601 formatted string for the provided Calendar instance, or null if call is null
      • toString

        public static String toString​(Date date,
                                      boolean withMsec)
        Get a ISO8601 formatted string for the provided Date instance.
        Parameters:
        date - the Date instance to get the ISO8601 formatted string for
        withMsec - flag indicating whether to include milliseconds
        Returns:
        a ISO8601 formatted string for the provided Date instance, or null if date is null
      • toString

        public static String toString​(Date date)
        Get a ISO8601 formatted string for the provided Date instance.
        Parameters:
        date - the Date instance to get the ISO8601 formatted string for
        Returns:
        a ISO8601 formatted string for the provided Date instance, or null if date is null
      • toInstant

        public static Instant toInstant​(String dateTimeString)
                                 throws ParseException
        Parses an ISO8601 formatted string a returns an Instant instance.
        Parameters:
        dateTimeString - the ISO8601 formatted string
        Returns:
        an Instant instance for the ISO8601 formatted string
        Throws:
        ParseException - if the provided string is not in the proper format
      • toDate

        public static Date toDate​(String dateTimeString)
                           throws ParseException
        Parses an ISO8601 formatted string a returns a Date instance.
        Parameters:
        dateTimeString - the ISO8601 formatted string
        Returns:
        a Date instance for the ISO8601 formatted string
        Throws:
        ParseException - if the provided string is not in the proper format
      • toCalendar

        public static Calendar toCalendar​(String dateTimeString)
                                   throws ParseException
        Parses an ISO8601 formatted string a returns a Calendar instance.
        Parameters:
        dateTimeString - the ISO8601 formatted string
        Returns:
        a Calendar instance for the ISO8601 formatted string
        Throws:
        ParseException - if the provided string is not in the proper format