Package com.itextpdf.kernel.xmp

Class XMPDateTimeFactory

java.lang.Object
com.itextpdf.kernel.xmp.XMPDateTimeFactory
public final class XMPDateTimeFactory extends Object
A factory to create XMPDateTime-instances from a Calendar or an ISO 8601 string or for the current time.
Since:
16.02.2006

  • Method Details

    • createFromCalendar

      public static XMPDateTime createFromCalendar (Calendar calendar)
      Creates an XMPDateTime from a Calendar-object.
      Parameters:
      calendar - a Calendar-object.
      Returns:
      An XMPDateTime-object.

    • create

      public static XMPDateTime create()
      Creates an empty XMPDateTime-object.
      Returns:
      Returns an XMPDateTime-object.

    • create

      public static XMPDateTime create (int year, int month, int day)
      Creates an XMPDateTime-object from initial values.
      Parameters:
      year - years
      month - months from 1 to 12
      Note: Remember that the month in Calendar is defined from 0 to 11.
      day - days
      Returns:
      Returns an XMPDateTime-object.

    • create

      public static XMPDateTime create (int year, int month, int day, int hour, int minute, int second, int nanoSecond)
      Creates an XMPDateTime-object from initial values.
      Parameters:
      year - years
      month - months from 1 to 12
      Note: Remember that the month in Calendar is defined from 0 to 11.
      day - days
      hour - hours
      minute - minutes
      second - seconds
      nanoSecond - nanoseconds
      Returns:
      Returns an XMPDateTime-object.

    • createFromISO8601

      public static XMPDateTime createFromISO8601 (String strValue) throws XMPException
      Creates an XMPDateTime from an ISO 8601 string.
      Parameters:
      strValue - The ISO 8601 string representation of the date/time.
      Returns:
      An XMPDateTime-object.
      Throws:
      XMPException - When the ISO 8601 string is non-conform

    • getCurrentDateTime

      public static XMPDateTime getCurrentDateTime()
      Obtain the current date and time.
      Returns:
      Returns The returned time is UTC, properly adjusted for the local time zone. The resolution of the time is not guaranteed to be finer than seconds.

    • setLocalTimeZone

      public static XMPDateTime setLocalTimeZone (XMPDateTime dateTime)
      Sets the local time zone without touching any other Any existing time zone value is replaced, the other date/time fields are not adjusted in any way.
      Parameters:
      dateTime - the XMPDateTime variable containing the value to be modified.
      Returns:
      Returns an updated XMPDateTime-object.

    • convertToUTCTime

      public static XMPDateTime convertToUTCTime (XMPDateTime dateTime)
      Make sure a time is UTC. If the time zone is not UTC, the time is adjusted and the time zone set to be UTC.
      Parameters:
      dateTime - the XMPDateTime variable containing the time to be modified.
      Returns:
      Returns an updated XMPDateTime-object.

    • convertToLocalTime

      public static XMPDateTime convertToLocalTime (XMPDateTime dateTime)
      Make sure a time is local. If the time zone is not the local zone, the time is adjusted and the time zone set to be local.
      Parameters:
      dateTime - the XMPDateTime variable containing the time to be modified.
      Returns:
      Returns an updated XMPDateTime-object.