<DATE> : Date field

Java class : leon.info.LyDateFieldInfo

ROLE

This element describes a temporal attribute. Several date types are supported: date & time, date only, time only, hours & minutes... Information about that kind of field could be completed by a format and a default value.

ATTRIBUTES

<!ATTLIST DATE
	  id ID #REQUIRED
	  template IDREF #IMPLIED
	  javaName NMTOKEN #IMPLIED
	  type ( DATE_TIME | DATE_HOUR_MIN | DATE | TIME | HOUR_MIN) "DATE_TIME"
	  behavior NMTOKEN #IMPLIED
	  withTimeZone ( true | false) "false">
Attribute Mand. Description Default
id yes Date field identifier.  
template no Reference to the date field used as pattern.  
javaName no Name of the JAVA attribute that corresponds to the current field when automatic code generation is used. The default value is the name of the current field.  
type no Type of this date field. Managed types are:
- DATE_TIME: Year-month-day-hour-minutes-seconds
- DATE_HOUR_MIN: Year-month-day-hour-minutes
- DATE: Year-month-day
- TIME: Hour-minutes-seconds
- HOUR_MIN: Hour-minutes
DATE_TIME
behavior no Name of the Java class representing the behavior of this field. Reserved for a future use.  
withTimeZone no DATE.withTimeZone false

ELEMENTS

<!ELEMENT DATE 
	  (%FIELD_BEGIN;,
	   (UNITS | UNITS_REF)?,
	   UNIT_REF?,
	   FORMAT?,
	   DEFAULT?,
	   %FIELD_END;)>
Element Mand. Mult. Description
FIELD_BEGIN
yes no Begin of field description.
UNITS yes no Dictionary of units of this field.
UNITS_REF yes no Reference on a dictionary of units of this field.
UNIT_REF no no Reference of the default unit for this field. This unit must belong to the dictionary of units of the field.
FORMAT no no This is the date format. The syntax followed is the one specified by the java.text.SimpleDateFormat class (see the standard Java API for JDK 1.1, 1.2, 1.3). The default format for the English locale is "MM/dd/yyyy HH/mm/ss". The default format for the French locale is "dd/MM/yyyy HH/mm/ss". This element is not used for date fields with the type HOUR.
Warning: this format only applies to the display of the values of the current field; it does not impact the values themselves.
DEFAULT no no This string should follow the defined format. The special string "_now" defines that the default value is the current time when it is asked inside the application. For example, when the user asked for the creation of an object, this date field inside the creation form contains the time this action has been invoked.
FIELD_END
yes no End of field description.application.

SAMPLE

<DATE id="creationDate" type='DATE_HOUR_MIN'>
	<NAME value="Creation date"/>
	<TAB value="Opening "/>
	<F_MARKS table='true' sort='true' notNull='true'/>
	<DEFAULT value="_now"/>
	<TIP value="Creation date, automatically filled in at the creation of a new object"/>
</DATE>