Class DateConverter

java.lang.Object
org.apache.pdfbox.util.DateConverter

public final class DateConverter extends 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 Details

    • toString

      public static String toString(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 String toISO8601(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 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 Calendar toCalendar(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.