Top
PowerCOBOL V11.0 Reference
FUJITSU Software

4.81 DateFormat Property

Description:

Defines the date format to be used.

Used in:

Control

Print

Object

RenderText

Value:

The date format is made up of macro strings and other text.

A macro string is one of the following:

yyyy: 4 digit year. (e.g. 1998)

Month: Fully spelt month. (e.g. December)

Mon:Abbreviated month. (e.g. Dec)

MMMM:Fully spelt month. Spelling depends on the system's regional settings.

MMM:Abbreviated month. The abbreviation depends on the system's regional settings.

MM:Numeric month. (1 to 12)

dd:Numeric day. (1 to 31)

Note that the strings are case sensitive.

For example, if the value is specified as "dd , Mon - yyyy", the date text "19981231" would be displayed or printed:
"31 , Dec - 1998"

The DateFormat property is only effective when the DateStyle property is "99-Custom".

RenderText

The DateStyle property, and hence the DateFormat property, is only effective when the RenderStyle property is "2 - Date".

The RenderText object converts a character string of the form "yyyyMMdd", or as defined by the InputFormat property, to the style indicated by the macro string.

If you specify a format that does not contain all elements of the date, PowerCOBOL substitutes the value 1 for the missing elements. For example, if there is no InputFormat set, and you enter "19981231" to a field with the format value "yyyy-MM", PowerCOBOL displays "1998-12", but the output value would be "19981201".

Default value:

None.

COBOL picture:

X, up to 8192 bytes.

OLE data type:

VT_BSTR

Design time access:

Set and reference.

Execution time access:

Print

Set and reference.

RenderText

Reference only.

Backward compatibility attribute:

None.