timeFormat

The timeFormat property identifies the format for times.

Valid values are as follows:
"pattern"
The value of pattern consists of a set of characters as described in Date, time, and timestamp format specifiers.

Characters may be dropped from the beginning or end of a complete time specification, but not from the middle.

defaultTimeFormat
The default value in a Java™ environment is set by the Java locale.
eurTimeFormat
The pattern HH.mm.ss, which is the IBM® European standard time format.
isoTimeFormat
The pattern HH.mm.ss, which is the time format specified by the International Standards Organization (ISO).
jisTimeFormat
The pattern HH:mm:ss, which is the Japanese Industrial Standard time format.
usaTimeFormat
The pattern hh:mm AM, which is the IBM USA standard time format.
The property is available in DataItem parts and is meaningful for fields that appear in the following contexts:
The property is used for both input and output, but not in the following cases:

Length considerations for times

In a form, the field length must match the length of the time mask you specify. In a page field, the rules are as follows:
  • The item length must be sufficient for the time mask you specify but can be longer
  • In the case of a numeric item, the separator characters are excluded from the length calculation.

I/O considerations for times

Data entered into a variable field is checked to ensure that the time was entered in the format specified. The user does not need to enter the leading zeros for hours, minutes, and second, but can specify (for example) 8:15 instead of 08:15. The user who omits the separator characters, however, must enter all leading zeros.

A time stored in internal format is not recognized as a time, but simply as data. If a 6-character time field is moved to a character item of length 10, for example, EGL pads the destination field with blanks. When the 6-character value is presented on a form, however, the time is converted from its internal format, as appropriate.

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.