com.ibm.as400.access
Class DateTimeConverter

java.lang.Object
  extended by com.ibm.as400.access.DateTimeConverter

public class DateTimeConverter
extends Object

A utility for converting date/time values. The system API QWCCVTDT is used to convert a date and time value from one format to another format.


Constructor Summary
Constructor and Description
DateTimeConverter(AS400 system)
          Constructs a DateTimeConverter object.
 
Method Summary
Modifier and Type Method and Description
 Date convert(byte[] data, String inFormat)
          Returns a converted Date object.
 byte[] convert(byte[] data, String inFormat, String outFormat)
          Converts date and time values from the input format to the requested output format.
 byte[] convert(Date date, String outFormat)
          Returns the converted date and time in a byte array.
static TimeZone timeZoneForSystem(AS400 system)
          Returns a TimeZone object to represent the time zone for the specified system.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DateTimeConverter

public DateTimeConverter(AS400 system)
Constructs a DateTimeConverter object.

Parameters:
system - The system.
Method Detail

convert

public byte[] convert(byte[] data,
                      String inFormat,
                      String outFormat)
               throws AS400SecurityException,
                      ErrorCompletingRequestException,
                      InterruptedException,
                      IOException,
                      ObjectDoesNotExistException
Converts date and time values from the input format to the requested output format.

This method effectively re-arranges the time format and returns it. The input and output values are relative to the same time zone. Therefore, no adjustments are made based on time-zone.

Parameters:
data - The date and time value to be converted.
inFormat - The input date and time format. Possible values are:
  • *CURRENT
  • *DTS
  • *JOB
  • *SYSVAL
  • *YMD
  • *YYMD
  • *MDY
  • *MDYY
  • *DMY
  • *DMYY
  • *JUL
  • *LONGJUL
outFormat - The output date and time format. Possible values are:
  • *DTS
  • *JOB
  • *SYSVAL
  • *YMD
  • *YYMD
  • *MDY
  • *MDYY
  • *DMY
  • *DMYY
  • *JUL
  • *LONGJUL
  • *DOS
Returns:
The converted date and time value.
Throws:
AS400SecurityException - If a security or authority error occurs.
ErrorCompletingRequestException - If an error occurs before the request is completed.
InterruptedException - If this thread is interrupted.
IOException - If an error occurs while communicating with the system.
ObjectDoesNotExistException - If the object does not exist on the system.

convert

public Date convert(byte[] data,
                    String inFormat)
             throws AS400SecurityException,
                    ErrorCompletingRequestException,
                    InterruptedException,
                    IOException,
                    ObjectDoesNotExistException
Returns a converted Date object.

Note: When *CURRENT is specified, the data parameter will not be used.

Parameters:
data - The date and time value to be converted. The value is assumed to be relative to the IBM i system's time zone.
inFormat - The format of the date and time value being provided. Possible values are:
  • *CURRENT
  • *DTS
  • *JOB
  • *SYSVAL
  • *YMD
  • *YYMD
  • *MDY
  • *MDYY
  • *DMY
  • *DMYY
  • *JUL
  • *LONGJUL
Returns:
The converted date and time.
Throws:
AS400SecurityException - If a security or authority error occurs.
ErrorCompletingRequestException - If an error occurs before the request is completed.
InterruptedException - If this thread is interrupted.
IOException - If an error occurs while communicating with the system.
ObjectDoesNotExistException - If the object does not exist on the system.

convert

public byte[] convert(Date date,
                      String outFormat)
               throws AS400SecurityException,
                      ErrorCompletingRequestException,
                      InterruptedException,
                      IOException,
                      ObjectDoesNotExistException
Returns the converted date and time in a byte array.

Parameters:
date - The Date object to be converted.
outFormat - The format of the returned date and time value. Possible values are:
  • *DTS
  • *JOB
  • *SYSVAL
  • *YMD
  • *YYMD
  • *MDY
  • *MDYY
  • *DMY
  • *DMYY
  • *JUL
  • *LONGJUL
Returns:
The converted date and time. The value is relative to the IBM i system's time zone.
Throws:
AS400SecurityException - If a security or authority error occurs.
ErrorCompletingRequestException - If an error occurs before the request is completed.
InterruptedException - If this thread is interrupted.
IOException - If an error occurs while communicating with the system.
ObjectDoesNotExistException - If the object does not exist on the system.

timeZoneForSystem

public static TimeZone timeZoneForSystem(AS400 system)
                                  throws AS400SecurityException,
                                         ErrorCompletingRequestException,
                                         InterruptedException,
                                         IOException,
                                         ObjectDoesNotExistException
Returns a TimeZone object to represent the time zone for the specified system. The TimeZone object will have the correct UTC offset for the system.

Parameters:
system - The IBM i system.
Returns:
A TimeZone object representing the time zone for the system.
Throws:
AS400SecurityException - If a security or authority error occurs.
ErrorCompletingRequestException - If an error occurs before the request is completed.
InterruptedException - If this thread is interrupted.
IOException - If an error occurs while communicating with the system.
ObjectDoesNotExistException - If the API used to retrieve the information does not exist on the system.