java.lang.Object
- com.iizix.prop.GProp<GProp<?>[]>
- - com.iizix.prop.PropCnr
  - - com.iizix.prop.ui.UIComp
    - - com.iizix.prop.ui.datetime.UIDateTime

All Implemented Interfaces:
EventListener, IFocusComp, IMessageBox, IComponent, ICustomDataProvider, IGProp<GProp<?>[]>, IPropCnr, IUIDateTime, IUIComp, IUICompRelativeTarget, IUIFocusComp, IUIHint, IUILabelForTarget, IUIDateTimeComponent, IUINullableValueComponent, IUIValueComponent, IVSComponentListener, IVSComponentState, IVSFieldListener, java.lang.Cloneable
Direct Known Subclasses:
EUIDateTime
```
public class UIDateTime
extends UIComp
implements IUIDateTime, IUIHint, IUILabelForTarget, IUIFocusComp, IUIDateTimeComponent, IUINullableValueComponent
```
Date/Time UI Component.
Author:
Christopher Mindus

Nested Class Summary
- Nested classes/interfaces inherited from interface com.iizix.gyro.IMessageBox
  IMessageBox.Icon
- Nested classes/interfaces inherited from interface com.iizix.prop.vs.IVSComponentState
  IVSComponentState.State

Field Summary
- Fields inherited from class com.iizix.prop.ui.UIComp
  EMPTY, REMOTE_FOCUS_EVENT, styles, vsField
- Fields inherited from class com.iizix.prop.PropCnr
  EMPTY_CLASSES, EMPTY_CNRS, EXTENDS_FRAMEWORK_ERROR_ID
- Fields inherited from class com.iizix.prop.GProp
  GPDEBUG, PROP_ATTR_STRING_EDITOR_PROP, PROP_ATTR_STRING_ERRORED_NAME, PROP_ATTR_STRING_EXTENDS, PROP_ATTR_STRING_EXTENDS_FINAL, PROP_ATTR_STRING_EXTENDS_PRIVATE, PROP_ATTR_STRING_NULLABLE, PROP_ATTR_STRING_PRIVATE, PROP_ATTR_STRING_PRIVATE_CHANGE_EVENT, PROP_ATTR_STRING_READ_ONLY, PROP_USER_1, PROP_USER_2
- Fields inherited from interface com.iizix.prop.IGProp
  EQC_ERROR_IGNORE_ALL, EQC_ERROR_IGNORE_REFERENCES, EQC_IGNORE_ARRAY, EQC_IGNORE_VOLATILE_OR_EDITOR, EQC_PRIVATE, EQC_SAVE_FILE, EXT_CONTAINER_EXTENDS, EXT_CONTAINER_EXTENDS_VALID, EXT_EXTENDED, EXT_FINAL, EXT_OVERRIDES, EXT_OVERRIDES_FINAL_ERR, EXT_PRIVATE
- Fields inherited from interface com.iizix.gyro.IMessageBox
  ICON_ERROR, ICON_INFORMATION, ICON_MAP, ICON_NONE, ICON_QUESTION, ICON_WARNING
- Fields inherited from interface com.iizix.prop.ui.IUIComp
  ERROR, INFORMATION, NONE, REMOTE_FOCUS_EVENT, WARNING
- Fields inherited from interface com.iizix.prop.ui.IUIHint
  PN_HINT

Constructor Summary

Constructors
Constructor	Description
`UIDateTime()`	Creates the component without a name.
`UIDateTime(Atom propertyAtom)`	Creates the component with the specified name.
`UIDateTime(Atom propertyAtom, GProp<?>[] newValue)`	Creates the component with the specified name, initialized to contain the `GProp` items.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Size`	`getApproximateSize()`	Returns the size of the component in pixels.
`UIDateTimeDataType`	`getDataType()`	Returns the date-time datatype for this component.
`GDateTime`	`getDefaultValue()`	Gets the default value of the component as a GDateTime.
`int`	`getDeviceType()`	Support for both mobile and desktop.
`int`	`getFormat()`	Gets the format used.
`GDateTime.Type`	`getGDateTimeType()`	Returns the GDateTime datatype for this component.
`java.time.LocalDate`	`getLocalDate()`	Gets the local date part of the value.
`int`	`getMaximumYear()`	Gets the maximum year for the mobile spinner.
`int`	`getMinimumYear()`	Gets the minimum year for the mobile spinner.
`UIDateTimeType`	`getUIDateTimeType()`	Returns the date-time type for this component.
`GDateTime`	`getValue()`	Gets the current date-time value.
`int`	`getVisualLength()`	Returns the visual length of the entry field.
`java.time.ZoneId`	`getZoneId()`	Gets the zone of the value.
`boolean`	`hasCalendarButton()`	Returns whether a button to show calendar should be present for date input (mobile only).
`boolean`	`isCalendarUsed()`	Returns whether a calendar should be used for date input (mobile only).
`boolean`	`isDataTypeEnforced()`	Returns if the enforcement of the datatype is set.
`boolean`	`isDateValueRequired()`	Returns if the implementation requires a date in the value component.
`boolean`	`isDateValueSupported()`	Returns if the implementation supports date.
`boolean`	`isDayMonthCombined()`	Returns whether to combine day and month in a single spinner (mobile).
`boolean`	`isMillisecondsUsed()`	Returns whether the time value should use milliseconds in time formats using seconds.
`boolean`	`isNullAllowed()`	Returns if a null value is allowed, i.e.
`boolean`	`isTimeValueRequired()`	Returns if the implementation requires a time in the value component.
`boolean`	`isTimeValueSupported()`	Returns if the implementation supports time.
`boolean`	`isZoneUsed()`	Returns whether the zone should be used for a ZonedTimeDate type.
`void`	`onEventSelf(GEvent event)`	Processes events.
`void`	`onValueChanged(VSField field, Value value, GProp<?> trigger, IPostEventProcessing postProcessing)`	Called when the field value is set.
`boolean`	`setCombineDayMonth(boolean on)`	Sets whether to combine day and month in a single spinner (mobile).
`int`	`setComponentToVSField()`	Sets the value from component to its VirtualSpace field, if any.
`static int`	`setComponentToVSField(UIComp dateTimeComp, VSField field)`	Sets the value from component to its VirtualSpace field, if any.
`boolean`	`setDate(java.time.LocalDate localDate)`	Sets the value as a local date with the locale information of the current user session (or system default) in case value conversion is required.
`boolean`	`setDate(java.time.LocalDate localDate, LocaleInfo localeInfo)`	Sets the value as a local date.
`boolean`	`setFormat(int format)`	Sets the format.
`boolean`	`setNullAllowed(boolean isNullAllowed)`	Sets the null value allowed flag, i.e.
`boolean`	`setType(UIDateTimeType type, UIDateTimeDataType dataType, boolean doEnforceDataType)`	Sets the date-time type, its datatype and the enforcement flag of the datatype.
`boolean`	`setUseCalendar(boolean on)`	Sets whether a calendar should be used for date input (mobile only).
`boolean`	`setUseCalendarButton(boolean on)`	Sets whether a calendar button should be shown for date input (mobile only).
`boolean`	`setUseMilliseconds(boolean on)`	Sets whether the time value should use milliseconds in time formats using seconds.
`boolean`	`setUseZone(boolean on)`	Sets whether the zone should be used for a ZonedTimeDate type.
`boolean`	`setValue(GDateTime value)`	Sets the date-time value with the locale information of the current user session (or system default) in case value conversion is required.
`boolean`	`setValue(GDateTime value, LocaleInfo localeInfo)`	Sets the date-time value.
`boolean`	`setValueToNull()`	Sets the value to null.
`boolean`	`setYearRange(int min, int max)`	Sets the minimum and maximum year for the mobile spinner.
`boolean`	`setZoneId(java.time.ZoneId zone)`	Sets the zone value.

Methods inherited from class com.iizix.prop.ui.UIComp
add, addMappings, assignFontInfoResolver, canAcceptUIContainerFocus, canAlignX, canAlignY, canFillX, canFillY, canRequestFocus, canRequestFocus, clearErrorMessage, clone, couldRequestFocusIfVirtualized, createStyles, createTitleProp, disconnectVSField, enterVSProcessing, exitVSProcessing, fireSelection, fireSelection, forbiddenGetCustomDataMap, getBadge, getBestVSFieldValueType, getComponentID, getComponentMappings, getErrorMessage, getErrorMessage, getErrorMessageEx, getErrorMessageString, getErrorMessageString, getErrorMessageStringEx, getFirstContainerVSStateFocus, getFixHeight, getFixWidth, getFontInfo, getForcedAlignX, getForcedAlignY, getKStringText, getLayout, getLayoutMgr, getLayoutMgr, getMappedVSComponent, getMessage, getMessageText, getPixelHeight, getPixelWidth, getPredefinedProps, getSize, getStyles, getStyles, getText, getTitle, getTitleKS, getTitlePKS, getTooltip, getTooltipText, getTrigger, getUIPanel, getUIParent, getValue, getValue, getVirtualSpace, getVSField, getVSStateFocus, hasExplicitHeight, hasExplicitWidth, hasFocus, hasImplicitAlignFillX, hasImplicitAlignFillY, hasImplicitHeight, hasImplicitWidth, hasSelectionChanged, isEnabled, isMobile, isReadOnly, isRTL, isVisible, isVSFieldDisconnected, mustHaveExplicitHeight, mustHaveExplicitWidth, mustHaveHeight, mustHaveWidth, onBroken, onComponentSelectedInParent, onFocusGained, onNotifySelectionChanged, onParentStateChanged, onPrepare, onPrepare, onPropDispose, onRemoteEvent, onResolved, onSelectionChanged, onStateChanged, onVirtualizationCompleted, processVSComponentSelection, reconnectVSField, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusEx, requestFocusEx, requestFocusEx, requestFocusEx, resetComponentID, setBadge, setBadge, setEnabled, setEnabled, setErrorMessage, setErrorMessage, setErrorMessage, setErrorMessage, setHTMLText, setLayoutMgr, setMessage, setMessage, setReadOnly, setReadOnly, setText, setText, setTitle, setTitle, setTitle, setTooltip, setTooltip, setUIContainerFocus, setVisible, setVisible, setVSFieldMessageToComponent, setVSFieldToComponent, verify, verifyComponentScope

Methods inherited from class com.iizix.prop.PropCnr
__transferChildProps, addPredefinedProps, addProp, addProp, addProp2, addProp2, appendPropValue, completeVirtualize, containsProp, containsProp, convertLoadedProp, createCopyOfAtom, createUniqueAtom, createUniqueAtom, createUniqueAtom, createVSReference, doPropEqualsArrayValues, doVirtualizePropCnr, enablePropCommunication, enablePropHashMap, equalsTree, equalsTree, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsContainer, getExtendsError, getExtendsName, getExtendsOverride, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropBaseReference, getPropCnr, getPropCount, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue0, getReferences, getRetargetedVerifyContainer, getString, getString, getString, getString, getValueClasses, getVSReference, hasSendData, initializeElement, initializeExtendsFramework, initializeProp, initializeValue, initPropCnr, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsPropertyValid, isExtendsRoot, isPropAddRemoveAllowed, isPropCommunicating, isPropExtended, isSibling, list, list, logPropNotFound, maybeAddProp, onInsertProp, onPropRemoved, onPropTreeInitialized, onReferenceEvent, paramString, prepare, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, replaceProps, requestFocus, requestFocusEx, resolveReferences, resolveRuntimeReferences, setBool, setBool, setBool, setBool, setCreateRequiredProp, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, shouldCreateProps, shouldSerializeToXML, toElementString, toNativeValue0, usePropHashMap, usesPropIndex, validateChildPropInValue, validateClassInstances, validatePropType, validatePropValue, verifyInternalUseOnly, verifyTree, virtualize

Methods inherited from class com.iizix.prop.GProp
addPropError, addPropListener, convertPropError, dispose, equals, equals, equalsErrors, equalsObj, equalsPropValue, equalValues, extendsClone, finalize, fine, fine, finer, finer, finest, finest, fromElementString, getAliasName, getAppSessionGyro, getAppWorker, getAtomPath, getAttribute, getChildReferencePropName, getClientSessionGyro, getClientWorker, getConstraints, getEnvironment, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropName, getFullPropNameDebug, getFullPropNameDebug, getListeners, getModuleFolder, getModuleFolder, getParent, getParent, getProjectName, getPropAtom, getPropError, getPropError, getPropErroredName, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromPath, getPropFromReference, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropReferenceTarget, getPropRootPropMgr, getPropTreeErrorSeverity, getPropValue, getPropValue, getPropValueObject, getReferencePropName, getRelativePropName, getRootFromName, getRootName, getRootParent, getRootParent, getTreeLock, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropForEditor, isPropNullable, isPropPrivate, isPropPrivateAtCreation, isPropReadOnly, isPropReferenceTreeValid, isPropRoot, isPropUSER, isPropValueTreeLockNeeded, isPropVirtualized, isPropVirtualizing, isPropVolatile, isPropVolatileOrEditorOnly, isProxied, list, list, list, mapAliasToReference, mapAliasToReference, mapReferenceToAlias, mapReferenceToAlias, mapReferenceToProjectRelative, modifyPropValue, moveProp, moveProp, moveProp, onEvent, onPropInvalidateCache, onPropParentChanged, onPropValueSet, onVirtualized, paramValue, post, post, removePropError, removePropListener, removePropUSER, renameProp, renameProp2, resetChangedTree, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPrivateCreateRequiredProp, setPropError, setPropErroredName, setPropExtended, setPropExtendsFinal, setPropExtendsPrivate, setPropForEditor, setPropNullable, setPropPrivate, setPropReadOnly, setPropUSER, setPropValue, setPropValue, setPropValue, setPropValueIncognito, setPropVolatile, severe, severe, severe, shouldSerializeToXML, throwIfReadOnly, toNativeValue, toString, toString, triggerRemoteEvent, triggerRemoteEvent, validateProp, verifyHasPropertyItem, warning, warning, warning

Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.iizix.IComponent
clearErrorMessage, getBadge, getKStringText, getLayoutMgr, getMessage, getMessageText, getStyles, getText, getTooltip, getTooltipText, getUIPanel, getUIParent, isEnabled, isReadOnly, isVisible, messageBox, requestFocus, requestFocus, requestFocusEx, requestFocusEx, setBadge, setBadge, setEnabled, setErrorMessage, setErrorMessage, setHTMLText, setLayoutMgr, setMessage, setMessage, setReadOnly, setText, setText, setTooltip, setTooltip, setVisible

Methods inherited from interface com.iizix.prop.ICustomDataProvider
forbiddenGetCustomDataMap, getCustomData, putCustomData, putCustomDataIfAbsent

Methods inherited from interface com.iizix.gyro.IFocusComp
requestFocus, requestFocus, requestFocusEx, requestFocusEx

Methods inherited from interface com.iizix.prop.IGProp
addPropError, addPropListener, dispose, equals, fine, fine, finer, finer, finest, finest, fromElementString, getAppSessionGyro, getAtomPath, getClientSessionGyro, getConstraints, getEnvironment, getErroredPropItems, getErroredProps, getErrorsProp, getExtendsRootContainer, getFullPropName, getFullPropNameDebug, getModuleFolder, getModuleFolder, getParent, getParent, getPropAtom, getPropBaseReference, getPropError, getPropError, getPropErrorSeverity, getPropExtendsFlags, getPropFromPath, getPropFromReference, getPropIndex, getPropName, getPropPath, getPropPath, getPropRootPropMgr, getPropTreeErrorSeverity, getPropValue, getPropValue, getReferencePropName, getReferences, getRelativePropName, getRootParent, getTreeLock, getValueClasses, getVSReference, hasChanged, hasPrivateChangeEventProp, hasPropError, hasPropTreeError, info, info, initializeGElement, initializeGProp, isDisposed, isPropChildOf, isPropClientCreated, isPropCommunicating, isPropCreateRequired, isPropExtended, isPropExtendsFinal, isPropExtendsPrivate, isPropExtendsPrivateInRoot, isPropExtendsPrivateInRoot, isPropFile, isPropFolder, isPropNullable, isPropPrivate, isPropReadOnly, isPropReferenceTreeValid, isPropRoot, isPropVirtualized, list, list, list, list, list, mapAliasToReference, mapReferenceToAlias, mapReferenceToProjectRelative, moveProp, moveProp, moveProp, onEvent, onPropTreeInitialized, onRemoteEvent, removePropError, removePropListener, renameProp, resolveRuntimeReferences, setChanged, setConstraints, setConstraints, setParent, setPrivateChangeEventProp, setPropError, setPropExtendsFinal, setPropExtendsPrivate, setPropNullable, setPropPrivate, setPropReadOnly, setPropValue, setPropValue, severe, severe, severe, toElementString, toNativeValue, triggerRemoteEvent, triggerRemoteEvent, validateProp, validatePropType, validatePropValue, verify, verifyHasPropertyItem, warning, warning, warning

Methods inherited from interface com.iizix.gyro.IMessageBox
messageBox, messageBox

Methods inherited from interface com.iizix.prop.IPropCnr
addProp, addProp, addProp2, addProp2, canRequestFocus, canRequestFocus, canRequestFocus, containsProp, containsProp, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, couldRequestFocusIfVirtualized, createCopyOfAtom, createUniqueAtom, createUniqueAtom, enablePropCommunication, enablePropHashMap, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getAllProps, getBool, getBool, getBool, getBool, getChildPropError, getChildPropError, getChildPropErrorSeverity, getChildPropErrorSeverity, getErrorsProp, getExtendsError, getExtendsName, getExtendsPossibleClasses, getFirstProp, getFirstProp, getFocusEngine, getInt, getInt, getInt, getInt, getLong, getLong, getLong, getLong, getNumber, getNumber, getNumber, getNumber, getPossibleChildren, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getProp, getPropCnr, getPropCount, getPropIndex, getPropIndex, getPropIndexes, getProps, getProps, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getPropValue, getString, getString, getString, getString, hasFocus, initializeExtendsFramework, insertProp, insertProp2, isChild, isExtendsOverriden, isExtendsRoot, isPropAddRemoveAllowed, isPropExtended, isSibling, removeAllProps, removeAllProps2, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, removeProp2, reorderProps, requestFocus, requestFocusEx, setBool, setBool, setBool, setBool, setExtendsName, setExtendsOverride, setInt, setInt, setInt, setLong, setLong, setLong, setLong, setNumber, setNumber, setNumber, setNumber, setProp, setProp, setProp, setProp2, setProp2, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setPropValue, setString, setString, setString, setString, usePropHashMap, usesPropIndex, validateClassInstances

Methods inherited from interface com.iizix.prop.ui.datetime.IUIDateTime
getDefaultValue, getLocalTime, setTime, setTime

Methods inherited from interface com.iizix.prop.ui.value.IUIDateTimeComponent
createValueProp, getValueOrDefault

Methods inherited from interface com.iizix.prop.ui.IUIFocusComp
onFocusGained, onFocusLost

Methods inherited from interface com.iizix.prop.ui.IUIHint
getHintKString, getHintString, setHint, setHint

Methods inherited from interface com.iizix.prop.ui.value.IUINullableValueComponent
isNull

Methods inherited from interface com.iizix.prop.vs.IVSComponentListener
onParentStateChanged

Methods inherited from interface com.iizix.prop.vs.IVSFieldListener
getBestVSFieldValueType, onBroken, onResolved, onStateChanged

- Constructor Detail
  - UIDateTime
```
public UIDateTime()
```
    Creates the component without a name. The name must be set in all cases using the setPropertyAtom call.
  - UIDateTime
```
public UIDateTime(Atom propertyAtom)
```
    Creates the component with the specified name. All system-reserved names for components begins with "$".
    Parameters:
    propertyAtom - the name of the component, unique within it's parent.
  - UIDateTime
```
public UIDateTime(Atom propertyAtom,
                  GProp<?>[] newValue)
           throws PropException
```
    Creates the component with the specified name, initialized to contain the GProp items. All system-reserved names for components begins with "$".
    Parameters:
    propertyAtom - The name of the component, unique within it's parent.
    newValue - The array of all properties the component should have.
    Throws:
    PropException - when at least one of the properties to initialize the component with is invalid.
- Method Detail
  - getDeviceType
```
public int getDeviceType()
```
    Support for both mobile and desktop.
    Specified by:
    getDeviceType in interface IUIComp
    Returns:
    0=both.
  - getUIDateTimeType
```
public UIDateTimeType getUIDateTimeType()
```
    Returns the date-time type for this component.
    Specified by:
    getUIDateTimeType in interface IUIDateTime
    Returns:
    Enum value as Time, Date, DateTime or ZoneId.
  - getDataType
```
public UIDateTimeDataType getDataType()
```
    Returns the date-time datatype for this component.
    Specified by:
    getDataType in interface IUIDateTime
    Returns:
    Enum value as Time, Date, DateTime or ZoneId.
  - getGDateTimeType
```
public GDateTime.Type getGDateTimeType()
```
    Returns the GDateTime datatype for this component.
    Specified by:
    getGDateTimeType in interface IUIDateTime
    Returns:
    Enum value as LocalTime, OffsetTime, LocalDate, LocalDateTime, OffsetDateTime or ZonedDateTime.
  - isDataTypeEnforced
```
public boolean isDataTypeEnforced()
```
    Returns if the enforcement of the datatype is set.
    Specified by:
    isDataTypeEnforced in interface IUIDateTime
    Returns:
    true if the datatype when setting the value MUST be exactly the same datatype, or false (default) to allow conversion to the internal configured datatype. In the Designer, this value is called "Allow data conversion", and is default true.
  - setType
```
public boolean setType(UIDateTimeType type,
                       UIDateTimeDataType dataType,
                       boolean doEnforceDataType)
```
    Sets the date-time type, its datatype and the enforcement flag of the datatype.
    Note 1: This method DOES NOT change the value, so the value may end up in the wrong datatype, and you should ensure that this does not occur.
    Note 2: The doEnforceDataType is always true for ZoneId type.
    Specified by:
    setType in interface IUIDateTime
    Parameters:
    type - The type.
    dataType - The datatype.
    doEnforceDataType - The enforcement flag: when true the datatype must match precisely, when false, data conversion is done internally to retrieve the datatype based on the current user's (or system) locale information.
    Returns:
    true if a change of type, datatype or enforcement occurred, false for no change.
    Throws:
    java.lang.IllegalArgumentException - If the type does not support the dataType.
  - onEventSelf
```
public void onEventSelf(GEvent event)
```
    Processes events.
    Specified by:
    onEventSelf in interface IGProp<GProp<?>[]>
    Overrides:
    onEventSelf in class UIComp
    Parameters:
    event - The property event.
  - setComponentToVSField
```
public int setComponentToVSField()
```
    Sets the value from component to its VirtualSpace field, if any.
    Specified by:
    setComponentToVSField in interface IUIComp
    Overrides:
    setComponentToVSField in class UIComp
    Returns:
    1 for update completed, 0 for nothing done and -1 for error occurred.
  - setComponentToVSField
```
public static int setComponentToVSField(UIComp dateTimeComp,
                                        VSField field)
```
    Sets the value from component to its VirtualSpace field, if any.
    Parameters:
    dateTimeComp - The date/time component.
    field - The field.
    Returns:
    1 for update completed, 0 for nothing done and -1 for error occurred.
  - onValueChanged
```
public void onValueChanged(VSField field,
                           Value value,
                           GProp<?> trigger,
                           IPostEventProcessing postProcessing)
```
    Called when the field value is set.
    Components must override to provide the implementation when they are not implementing IPlainTextComponent, in this case the default implementation transports the field string value to this text components plain text.
    Specified by:
    onValueChanged in interface IVSFieldListener
    Overrides:
    onValueChanged in class UIComp
    Parameters:
    field - The VS field.
    value - The value, never null, but value.isNull() could be true.
    trigger - The trigger property that may be null.
    postProcessing - Post-processing instance.
  - isNullAllowed
```
public boolean isNullAllowed()
```
    Returns if a null value is allowed, i.e. no date/time value is set and the UI component is blank.
    Specified by:
    isNullAllowed in interface IUIDateTime
    Specified by:
    isNullAllowed in interface IUINullableValueComponent
    Returns:
    true if null is allowed, or false (default) if not allowed.
  - setNullAllowed
```
public boolean setNullAllowed(boolean isNullAllowed)
```
    Sets the null value allowed flag, i.e. allows no date/time value to be set and the UI component is blank.
    Setting this parameter isNullAllowed to false when the value already is null will not affect the value.
    Specified by:
    setNullAllowed in interface IUIDateTime
    Specified by:
    setNullAllowed in interface IUINullableValueComponent
    Parameters:
    isNullAllowed - Flag for null allowed.
    Returns:
    true if the setting changed, false for no change.
  - setValueToNull
```
public boolean setValueToNull()
```
    Sets the value to null.
    Specified by:
    setValueToNull in interface IUIDateTime
    Specified by:
    setValueToNull in interface IUINullableValueComponent
    Returns:
    true for value changed, false for no change.
    Throws:
    java.lang.IllegalStateException - If the flag isNullAllowed() is false.
  - setValue
```
public boolean setValue(GDateTime value)
```
    Sets the date-time value with the locale information of the current user session (or system default) in case value conversion is required.
    Specified by:
    setValue in interface IUIDateTime
    Specified by:
    setValue in interface IUIDateTimeComponent
    Parameters:
    value - The value to set, null may be allowed depending on the flag returned by isNullAllowed().
    Returns:
    true for value changed, false for no change to the value.
    Throws:
    java.lang.IllegalArgumentException - If the date/time type is enforced and not matching.
    java.lang.IllegalStateException - If the date/time conversion cannot possibly take place due to type mismatch.
    java.lang.NullPointerException - If the value is null and allow null is not enabled.
  - setValue
```
public boolean setValue(GDateTime value,
                        LocaleInfo localeInfo)
```
    Sets the date-time value.
    Specified by:
    setValue in interface IUIDateTime
    Parameters:
    value - The value to set, null may be allowed depending on the flag returned by isNullAllowed().
    localeInfo - The locale information to use, or null to use the current user's or system default.
    Returns:
    true for value changed, false for no change to the value.
    Throws:
    java.lang.IllegalArgumentException - If the date/time type is enforced and not matching.
    java.lang.IllegalStateException - If the date/time conversion cannot possibly take place due to type mismatch.
    java.lang.NullPointerException - If the value is null and allow null is not enabled.
  - getValue
```
public GDateTime getValue()
```
    Gets the current date-time value.
    Specified by:
    getValue in interface IUIDateTime
    Specified by:
    getValue in interface IUIDateTimeComponent
    Returns:
    The current value as configured with its datatype's corresponding GDateTime value, or null if the value is null and the flag isNullAllowed() is set. The value may still be null if the "null-allowed" flag has been toggled recently programmatically to false but the value has not been assigned yet.
  - getDefaultValue
```
public GDateTime getDefaultValue()
```
    Gets the default value of the component as a GDateTime.
    Specified by:
    getDefaultValue in interface IUIDateTime
    Specified by:
    getDefaultValue in interface IUIDateTimeComponent
    Returns:
    The default value depends on the date/time type, i.e. the time as midnight as a LocalTime (00:00:00 for type Time), the epoch date as a LocalDate (1st of January 1970 for type Date), the combination of the two above for type DateTime, and the current Zone ID of the user's session (or system default) for ZoneId.
  - isTimeValueSupported
```
public boolean isTimeValueSupported()
```
    Returns if the implementation supports time.
    Specified by:
    isTimeValueSupported in interface IUIDateTime
    Specified by:
    isTimeValueSupported in interface IUIDateTimeComponent
    Returns:
    false when time is not supported, true when setting a value requires a time part.
  - isTimeValueRequired
```
public boolean isTimeValueRequired()
```
    Returns if the implementation requires a time in the value component.
    Specified by:
    isTimeValueRequired in interface IUIDateTime
    Specified by:
    isTimeValueRequired in interface IUIDateTimeComponent
    Returns:
    true when time is required in the component, and null is not allowed.
  - isDateValueSupported
```
public boolean isDateValueSupported()
```
    Returns if the implementation supports date.
    Specified by:
    isDateValueSupported in interface IUIDateTime
    Specified by:
    isDateValueSupported in interface IUIDateTimeComponent
    Returns:
    false when date is not supported, true when setting a value requires a date part.
  - isDateValueRequired
```
public boolean isDateValueRequired()
```
    Returns if the implementation requires a date in the value component.
    Specified by:
    isDateValueRequired in interface IUIDateTime
    Specified by:
    isDateValueRequired in interface IUIDateTimeComponent
    Returns:
    true when date is required in the component, and null is not allowed.
  - getLocalDate
```
public java.time.LocalDate getLocalDate()
```
    Gets the local date part of the value.
    Specified by:
    getLocalDate in interface IUIDateTime
    Returns:
    Only the date part of the value, or null if the value is null.
    Throws:
    java.lang.IllegalStateException - If the value doesn't contain a date part, i.e. it's the wrong datatype.
  - setDate
```
public boolean setDate(java.time.LocalDate localDate)
```
    Sets the value as a local date with the locale information of the current user session (or system default) in case value conversion is required.
    If the component is configured for the UIDateTimeType.DateTime, this will change only the date part of the value and keep offset, zone and/or date parts. To set the entire value, use setValue(GDateTime) or setValue(GDateTime, LocaleInfo).
    Specified by:
    setDate in interface IUIDateTime
    Parameters:
    localDate - The local date to set, null is not allowed.
    Throws:
    java.lang.IllegalArgumentException - If the date/time type is enforced and not matching, or in case the datatype is UIDateTimeType.Time.
    java.lang.NullPointerException - If localDate is null or in case the CURRENT value is null and the datatype is UIDateTimeType.DateTime.
  - setDate
```
public boolean setDate(java.time.LocalDate localDate,
                       LocaleInfo localeInfo)
```
    Sets the value as a local date.
    If the component is configured for the UIDateTimeType.DateTime, this will change only the date part of the value and keep offset, zone and/or date parts. To set the entire value, use setValue(GDateTime) or setValue(GDateTime, LocaleInfo).
    Specified by:
    setDate in interface IUIDateTime
    Parameters:
    localDate - The local date to set, null is not allowed.
    localeInfo - The locale information to use, or null to use the current user's or system default.
    Throws:
    java.lang.IllegalArgumentException - If the date/time type is enforced and not matching, or in case the datatype is UIDateTimeType.Time or UIDateTimeType.ZoneId.
    java.lang.NullPointerException - If localDate is null or in case the CURRENT value is null and the datatype is UIDateTimeType.DateTime.
  - getZoneId
```
public java.time.ZoneId getZoneId()
```
    Gets the zone of the value.
    Specified by:
    getZoneId in interface IUIDateTime
    Returns:
    Only the zone part of the value, or null if the value is null or doesn't have a zone. It is non-null only when the value is non-null and datatype is one of OffsetTime, OffsetDateTime, ZonedDateTime or ZoneId.
  - setZoneId
```
public boolean setZoneId(java.time.ZoneId zone)
```
    Sets the zone value.
    If the component is configured for the UIDateTimeType.DateTime, this will change only the zone part of the value.
    Specified by:
    setZoneId in interface IUIDateTime
    Parameters:
    zone - The local date to set, null is not allowed.
    Throws:
    java.lang.IllegalArgumentException - If the date/time type is enforced and not matching, or in case the datatype is UIDateTimeType.ZoneId.
    java.lang.NullPointerException - If zone is null or in case the CURRENT value is null and the datatype is UIDateTimeType.DateTime.
  - getFormat
```
public int getFormat()
```
    Gets the format used.
    Specified by:
    getFormat in interface IUIDateTime
    Returns:
    The format as 0=short, 1=normal, 2=long or 3=full (default).
  - setFormat
```
public boolean setFormat(int format)
```
    Sets the format.
    Specified by:
    setFormat in interface IUIDateTime
    Parameters:
    format - The format as 0=short, 1=normal, 2=long or 3=full (default).
    Returns:
    true for changes, false for no change.
    Throws:
    java.lang.IllegalArgumentException - If the format is not 0-3.
  - getMinimumYear
```
public int getMinimumYear()
```
    Gets the minimum year for the mobile spinner.
    Specified by:
    getMinimumYear in interface IUIDateTime
    Returns:
    The minimum year, or -1 if undefined.
  - getMaximumYear
```
public int getMaximumYear()
```
    Gets the maximum year for the mobile spinner.
    Specified by:
    getMaximumYear in interface IUIDateTime
    Returns:
    The minimum year, or -1 if undefined.
  - setYearRange
```
public boolean setYearRange(int min,
                            int max)
```
    Sets the minimum and maximum year for the mobile spinner.
    Specified by:
    setYearRange in interface IUIDateTime
    Parameters:
    min - The minimum year, or -1 for no minimum, i.e. current year minus 20.
    max - The maximum year, or -1 for no maximum, i.e. current year plus 20.
    Returns:
    true for changed, false for no change.
    Throws:
    java.lang.IllegalArgumentException - If the min is larger than max or if either min or max is not in the range of 0-10_000.
  - isZoneUsed
```
public boolean isZoneUsed()
```
    Returns whether the zone should be used for a ZonedTimeDate type.
    Specified by:
    isZoneUsed in interface IUIDateTime
    Returns:
    true to use the zone or false (default) not to use the zone.
  - setUseZone
```
public boolean setUseZone(boolean on)
```
    Sets whether the zone should be used for a ZonedTimeDate type.
    Specified by:
    setUseZone in interface IUIDateTime
    Parameters:
    on - The flag.
    Returns:
    true for changes, false for no change.
  - isCalendarUsed
```
public boolean isCalendarUsed()
```
    Returns whether a calendar should be used for date input (mobile only).
    Specified by:
    isCalendarUsed in interface IUIDateTime
    Returns:
    true to use the calendar or false (default) to use spinners.
  - setUseCalendar
```
public boolean setUseCalendar(boolean on)
```
    Sets whether a calendar should be used for date input (mobile only).
    Specified by:
    setUseCalendar in interface IUIDateTime
    Parameters:
    on - The flag.
    Returns:
    true for changes, false for no change.
  - hasCalendarButton
```
public boolean hasCalendarButton()
```
    Returns whether a button to show calendar should be present for date input (mobile only).
    Specified by:
    hasCalendarButton in interface IUIDateTime
    Returns:
    true to use the calendar or false (default) to use spinners.
  - setUseCalendarButton
```
public boolean setUseCalendarButton(boolean on)
```
    Sets whether a calendar button should be shown for date input (mobile only).
    Specified by:
    setUseCalendarButton in interface IUIDateTime
    Parameters:
    on - The flag.
    Returns:
    true for changes, false for no change.
  - isMillisecondsUsed
```
public boolean isMillisecondsUsed()
```
    Returns whether the time value should use milliseconds in time formats using seconds.
    Specified by:
    isMillisecondsUsed in interface IUIDateTime
    Returns:
    true to use the zone or false (default) not to use the zone.
  - setUseMilliseconds
```
public boolean setUseMilliseconds(boolean on)
```
    Sets whether the time value should use milliseconds in time formats using seconds.
    Specified by:
    setUseMilliseconds in interface IUIDateTime
    Parameters:
    on - The flag.
    Returns:
    true for changes, false for no change.
  - isDayMonthCombined
```
public boolean isDayMonthCombined()
```
    Returns whether to combine day and month in a single spinner (mobile).
    Specified by:
    isDayMonthCombined in interface IUIDateTime
    Returns:
    The flag, default false.
  - setCombineDayMonth
```
public boolean setCombineDayMonth(boolean on)
```
    Sets whether to combine day and month in a single spinner (mobile).
    Specified by:
    setCombineDayMonth in interface IUIDateTime
    Parameters:
    on - The flag.
    Returns:
    true for changes, false for no change.
  - getVisualLength
```
public int getVisualLength()
```
    Returns the visual length of the entry field.
    Returns:
    The visual length or 15 by default.
  - getApproximateSize
```
public Size getApproximateSize()
```
    Returns the size of the component in pixels. The size is a calculation and does not exactly reflect the real size that may be different due to additional styles not taken into account by this method. The size is calculated from the font of the component and default or defined values (such as character length or number of lines for text area).
    Specified by:
    getApproximateSize in class UIComp
    Returns:
    The size of the component.

Class UIDateTime

Nested Class Summary

Nested classes/interfaces inherited from interface com.iizix.gyro.IMessageBox

Nested classes/interfaces inherited from interface com.iizix.prop.vs.IVSComponentState

Field Summary

Fields inherited from class com.iizix.prop.ui.UIComp

Fields inherited from class com.iizix.prop.PropCnr

Fields inherited from class com.iizix.prop.GProp

Fields inherited from interface com.iizix.prop.IGProp

Fields inherited from interface com.iizix.gyro.IMessageBox

Fields inherited from interface com.iizix.prop.ui.IUIComp

Fields inherited from interface com.iizix.prop.ui.IUIHint

Constructor Summary

Method Summary

Methods inherited from class com.iizix.prop.ui.UIComp

Methods inherited from class com.iizix.prop.PropCnr

Methods inherited from class com.iizix.prop.GProp

Methods inherited from class java.lang.Object

Methods inherited from interface com.iizix.IComponent

Methods inherited from interface com.iizix.prop.ICustomDataProvider

Methods inherited from interface com.iizix.gyro.IFocusComp

Methods inherited from interface com.iizix.prop.IGProp

Methods inherited from interface com.iizix.gyro.IMessageBox

Methods inherited from interface com.iizix.prop.IPropCnr

Methods inherited from interface com.iizix.prop.ui.IUIComp

Methods inherited from interface com.iizix.prop.ui.datetime.IUIDateTime

Methods inherited from interface com.iizix.prop.ui.value.IUIDateTimeComponent

Methods inherited from interface com.iizix.prop.ui.IUIFocusComp

Methods inherited from interface com.iizix.prop.ui.IUIHint

Methods inherited from interface com.iizix.prop.ui.value.IUINullableValueComponent

Methods inherited from interface com.iizix.prop.vs.IVSComponentListener

Methods inherited from interface com.iizix.prop.vs.IVSFieldListener

Constructor Detail

UIDateTime

UIDateTime

UIDateTime

Method Detail

getDeviceType

getUIDateTimeType

getDataType

getGDateTimeType

isDataTypeEnforced

setType

onEventSelf

setComponentToVSField

setComponentToVSField

onValueChanged

isNullAllowed

setNullAllowed

setValueToNull

setValue

setValue

getValue

getDefaultValue

isTimeValueSupported

isTimeValueRequired

isDateValueSupported

isDateValueRequired

getLocalDate

setDate

setDate

getZoneId

setZoneId

getFormat

setFormat

getMinimumYear

getMaximumYear

setYearRange

isZoneUsed

setUseZone

isCalendarUsed

setUseCalendar

hasCalendarButton

setUseCalendarButton

isMillisecondsUsed

setUseMilliseconds

isDayMonthCombined

setCombineDayMonth

getVisualLength

getApproximateSize