Class DateConverter


  • public final class DateConverter
    extends java.lang.Object
    Converts dates to strings and back using the PDF date standard in section 3.8.2 of PDF Reference 1.7.
    Author:
    Ben Litchfield, Fred Hansen TODO Move members of this class elsewhere for shared use in pdfbox and xmpbox.
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.util.Calendar toCalendar​(java.lang.String text)
      Returns the Calendar for a given string containing a date, or null if it cannot be parsed.
      static java.util.Calendar toCalendar​(COSString text)
      Returns the Calendar for a given COS string containing a date, or null if it cannot be parsed.
      static java.lang.String toISO8601​(java.util.Calendar cal)
      Converts the date to ISO 8601 string format: yyyy-mm-ddThh:MM:ss#hh:mm (where '#" is '+' or '-').
      static java.lang.String toString​(java.util.Calendar cal)
      Converts a Calendar to a string formatted as: D:yyyyMMddHHmmss#hh'mm' where # is Z, +, or -.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • toString

        public static java.lang.String toString​(java.util.Calendar cal)
        Converts a Calendar to a string formatted as: D:yyyyMMddHHmmss#hh'mm' where # is Z, +, or -.
        Parameters:
        cal - The date to convert to a string. May be null. The DST_OFFSET is included when computing the output time zone.
        Returns:
        The date as a String to be used in a PDF document, or null if the cal value is null
      • toISO8601

        public static java.lang.String toISO8601​(java.util.Calendar cal)
        Converts the date to ISO 8601 string format: yyyy-mm-ddThh:MM:ss#hh:mm (where '#" is '+' or '-').
        Parameters:
        cal - The date to convert. Must not be null. The DST_OFFSET is included in the output value.
        Returns:
        The date represented as an ISO 8601 string.
      • toCalendar

        public static java.util.Calendar toCalendar​(COSString text)
        Returns the Calendar for a given COS string containing a date, or null if it cannot be parsed. The returned value will have 0 for DST_OFFSET.
        Parameters:
        text - A COS string containing a date.
        Returns:
        The Calendar that the text string represents, or null if it cannot be parsed.
      • toCalendar

        public static java.util.Calendar toCalendar​(java.lang.String text)
        Returns the Calendar for a given string containing a date, or null if it cannot be parsed. The returned value will have 0 for DST_OFFSET.
        Parameters:
        text - A COS string containing a date.
        Returns:
        The Calendar that the text string represents, or null if it cannot be parsed.