com.goldencode.p2j.ui.client.format

Class DateFormat

java.lang.Object

com.goldencode.p2j.ui.client.format.DisplayFormat

com.goldencode.p2j.ui.client.format.DateFormat

public class DateFormat
extends DisplayFormat

Display format for date variables.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	DateFormat.DateBuf Internal form of date data.
private static class	DateFormat.DateComponent The simple structure which records what places are occupied in a screen value by the date component.
private class	DateFormat.TestCase Simple testcase wrapper to check the year autocompletion and its string-to-number conversion.

Nested classes/interfaces inherited from class com.goldencode.p2j.ui.client.format.DisplayFormat

DisplayFormat.Presentation

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	dateCompOrder Order of date components for rendering.
protected int	DAY_IDX Index of the day component in the arrays of parsed components.
(package private) static java.util.regex.Pattern	digitsPattern One or more digits regexp
protected DateFormat.DateComponent[]	fmtDateComps How date components are positioned in rendered string.
protected boolean	fmtFullYear true for a 4-digit year.
(package private) static java.util.regex.Pattern	integerPattern Signed integer regexp
protected int	MONTH_IDX Index of the month component in the arrays of parsed components.
protected ParsedDateFormat	parsed Parsed format string.
protected int	YEAR_IDX Index of the year component in the arrays of parsed components.

Fields inherited from class com.goldencode.p2j.ui.client.format.DisplayFormat

editableSource, fmtScreenWidth

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DateFormat(DateFormat orig) Create a copy the original format.
	DateFormat(java.lang.String pformat) Constructs a date format from the given Progress format string.

Method Summary

Modifier and Type	Method and Description
DisplayFormat.Presentation	clear(DisplayFormat.Presentation pres) Returns a new presentation instance with a default initialized insert mode and cursor position.
DisplayFormat	duplicate() Duplicate this instance.
private static int	extractNumber(java.lang.String s) Parse argument for a sequence of at least one digit and parse the result as an integer.
private static int	extractParseComponent(java.lang.String src, int startIdx, int length, int maxLength, java.util.List<ErrorManager.ErrorEntry> errors) Extract a substring from the argument and parse it as unsigned integer.
DisplayFormat.Presentation	fromVar(BaseDataType var) Initializes a presentation for variable's value.
private static void	handleDateError(int errno, java.util.List<ErrorManager.ErrorEntry> errors) Report or raise a numbered date parse error.
protected boolean	hasFmtSeparator() Report if the format string includes separators.
boolean	isFormatCheck() Verify if this format needs explicit validation.
static void	main(java.lang.String[] args) Start all year autocompletion and its string-to-number conversion testcases.
(package private) static int	safeParseInteger(java.lang.String s, java.util.function.IntSupplier defaultValue) Parse text into an integer, do not throw exceptions
void	test() Execute all year autocompletion and its string-to-number conversion testcases.
private static date	toDateNoDelimiters(java.lang.String src, int maxLength, boolean year4digits, java.util.List<ErrorManager.ErrorEntry> errors) Parse a string to a date for formats with no delimiters.

Methods inherited from class com.goldencode.p2j.ui.client.format.DisplayFormat

clear, formatScreenValue, fromVar4FieldValue, generateQuestions, generateSpaces, genValueCannotBeDisplayedError, getFormatDef, getScreenWidth, instanceOfType, instanceOfType, instanceOfType, isCharInterface, isRightPositioning, isZapSupported, setCharInterface, setEditableSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

dateCompOrder

protected byte[] dateCompOrder

Order of date components for rendering.

DAY_IDX

protected int DAY_IDX

Index of the day component in the arrays of parsed components.

fmtDateComps

protected DateFormat.DateComponent[] fmtDateComps

How date components are positioned in rendered string. This array is directly indexed by the component's code constants (DAY etc.).

fmtFullYear

protected boolean fmtFullYear

true for a 4-digit year.

MONTH_IDX

protected int MONTH_IDX

Index of the month component in the arrays of parsed components.

parsed

protected final ParsedDateFormat parsed

Parsed format string.

YEAR_IDX

protected int YEAR_IDX

Index of the year component in the arrays of parsed components.

digitsPattern

static final java.util.regex.Pattern digitsPattern

One or more digits regexp

integerPattern

static final java.util.regex.Pattern integerPattern

Signed integer regexp

Constructor Detail

DateFormat

public DateFormat(java.lang.String pformat)
           throws ErrorConditionException

Constructs a date format from the given Progress format string.

Parameters:

pformat - Progress format string.

Throws:

ErrorConditionException - When passed format is not a valid date format.

DateFormat

protected DateFormat(DateFormat orig)

Create a copy the original format.

Parameters:

orig - The format to copy.

Method Detail

main

public static void main(java.lang.String[] args)

Start all year autocompletion and its string-to-number conversion testcases.

Parameters:

args - Command line arguments.

safeParseInteger

static final int safeParseInteger(java.lang.String s,
                                  java.util.function.IntSupplier defaultValue)

Parse text into an integer, do not throw exceptions

Parameters:

s - source string

defaultValue - call this if the source cannot be parsed into an integer.

Returns:

either the parse result, or the result of call to default value supplier

extractNumber

private static final int extractNumber(java.lang.String s)

Parse argument for a sequence of at least one digit and parse the result as an integer. Return 0, if the argument has no digits.

Parameters:

s - the source string

Returns:

see above

extractParseComponent

private static int extractParseComponent(java.lang.String src,
                                         int startIdx,
                                         int length,
                                         int maxLength,
                                         java.util.List<ErrorManager.ErrorEntry> errors)

Extract a substring from the argument and parse it as unsigned integer. Report or raise error 85 in case the extracted value cannot be parsed.

Parameters:

src - the source string

startIdx - the start index to extract

length - the component length

maxLength - component end limit

errors - if not null, then the first error encountered will be appended to the list, and 0 will be returned. otherwise errors will be thrown.

Returns:

the parsed component or 0 in case of an error

handleDateError

private static final void handleDateError(int errno,
                                          java.util.List<ErrorManager.ErrorEntry> errors)

Report or raise a numbered date parse error.

Parameters:

errno - the error number

errors - if not null, then the first error encountered will be appended to the list, and 0 will be returned. otherwise errors will be thrown.

toDateNoDelimiters

private static final date toDateNoDelimiters(java.lang.String src,
                                             int maxLength,
                                             boolean year4digits,
                                             java.util.List<ErrorManager.ErrorEntry> errors)

Parse a string to a date for formats with no delimiters. On return of this method either a successfully parsed date is returned, or in case of errors, the error list as updated with an error entry and null is returned.

Parameters:

src - the string to parse

maxLength - the length to parse

year4digits - if true the year is 4 digits, otherwise 2 digits

errors - optional errors, if not null, then error entries will be appended to this list instead or being thrown

Returns:

the date parsed or null in case of parse error

clear

public DisplayFormat.Presentation clear(DisplayFormat.Presentation pres)

Returns a new presentation instance with a default initialized insert mode and cursor position.

Specified by:

clear in class DisplayFormat

Parameters:

pres - A Presentation instance which was constructed by this format. May be null. This presentation instance is not changed in this method.

Returns:

New presentation instance.

duplicate

public DisplayFormat duplicate()

Duplicate this instance.

Specified by:

duplicate in class DisplayFormat

Returns:

See above.

fromVar

public DisplayFormat.Presentation fromVar(BaseDataType var)
                                   throws DisplayFormatCheckException

Initializes a presentation for variable's value.

Specified by:

fromVar in class DisplayFormat

Parameters:

var - Variable which should be compatible with format.

Returns:

Data presentation

Throws:

DisplayFormatCheckException - Variable's value is incompatible with format.

isFormatCheck

public boolean isFormatCheck()

Verify if this format needs explicit validation.

Overrides:

isFormatCheck in class DisplayFormat

Returns:

always true.

test

public void test()

Execute all year autocompletion and its string-to-number conversion testcases.

hasFmtSeparator

protected boolean hasFmtSeparator()

Report if the format string includes separators.

Returns:

true if the format string had a separator.