TIMF gate, FORMAT_TIME function

This function formats a time specified in ABSTIME format into one or more date or time formats.

Input Parameters

ABSTIME
A time specified in ABSTIME format consisting of an eight-byte packed decimal number containing the number of milliseconds since midnight on 1 January 1900. The parameter can be specified in the range -9435484800000 to +255611289599999, corresponding to years from 1601 to 9999 respectively.
ZONE
Optional Parameter
The time zone associated with the ABSTIME parameter.
Values for the parameter are:
  • GMT
  • LOCAL

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
  • SEVERE_ERROR
The following values are returned when RESPONSE is EXCEPTION:
  • DAYNUM_INVALID
  • GMT_INCORRECT
  • INVALID_ABSTIME
  • MONTH_INVALID
  • TIME_INVALID
  • UNSUPPORTED_FORMAT
  • WEEKDAY_INVALID
  • YEAR_INVALID
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
The following values are returned when RESPONSE is INVALID:
  • NO_INPUT_TIME
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
BINARY_DAY
Optional Parameter
The day of the month, expressed as a binary number.
BINARY_DAY_OF_YEAR
Optional Parameter
The day of the year, expressed as a binary number.
BINARY_HOUR
Optional Parameter
The hours portion of the time in hh:mm:ss.ddd format, expressed as a binary number.
BINARY_MILLISECOND
Optional Parameter
The fractional seconds portion of the time in hh:mm:ss.ddd format, expressed as a binary number.
BINARY_MINUTE
Optional Parameter
The minute section of the time , expressed as a binary number.
BINARY_MONTH
Optional Parameter
The month of the year, expressed as a binary number.
BINARY_SECOND
Optional Parameter
The seconds portion of the time in hh:mm:ss.ddd format, expressed as a binary number.
BINARY_YEAR
Optional Parameter
The year, expressed as a binary number.
DAY
Optional Parameter
The day of the month.
DAY_OF_YEAR
Optional Parameter
The day of the year.
HOUR
Optional Parameter
The hours portion of the time in hh:mm:ss.ddd format.
JULIAN_DATE
Optional Parameter
The Julian date
MILLISECOND
Optional Parameter
The fractional seconds portion of the time in hh:mm:ss.ddd format, expressed as a binary number.
MINUTE
Optional Parameter
The minutes portion of the time in hh:mm:ss.ddd format, expressed as a binary number.
MONTH
Optional Parameter
The month of the year
RFC1123_DATE
Optional Parameter
The date in RFC1123 format.
RFC3339_DATE
Optional Parameter
The date in RFC3339 format.
SECOND
Optional Parameter
The whole seconds portion of the time in hh:mm:ss.ddd format, expressed as a binary number.
TIMER_UNITS
Optional Parameter
The time expressed in zSeries timer units (1/300 second).
WEEKDAY_NUMBER
Optional Parameter
The index of the day within the week. Sunday has an index of 0.
YEAR
Optional Parameter
The year.