• Home/
• Formtools/
• datetime

datetime

Field component to liase with all datetime types

Examples

Basic

<cfproperty
    name="basicDate" type="date" hint="something meaningful" required="no" default=""
    ftseq="1" ftfieldset="General" ftwizardStep="General Details"
    ftType="datetime" ftlabel="Basic Date" />

Default to todays date

<cfproperty
    name="someDate" type="date" hint="The start date of the event" required="no" default=""
    ftseq="2" ftfieldset="General" ftwizardStep="General Details"
    ftDefaultType="Evaluate" ftDefault="now()" ftType="datetime" ftlabel="Some Date" />

Custom date and time format mask

<cfproperty
    name="someDate" type="date" hint="The start date of the event" required="no" default=""
    ftseq="3" ftfieldset="General" ftwizardStep="General Details"
    ftType="datetime" ftDateFormatMask="dd mmm yyyy" ftTimeFormatMask="hh:mm tt" 
    ftlabel="Some Date" />

Show date only

<cfproperty
    name="dateOnly" type="date" hint="The start date of the event" required="no" default=""
    ftseq="4" ftfieldset="General" ftwizardStep="General Details"
    ftType="datetime" ftShowTime="false" ftlabel="Date Only" />

Disable dateTime field by default

<cfproperty
    name="someDate" type="date" hint="The start date of the event" required="no" default=""
    ftseq="5" ftfieldset="General" ftwizardStep="General Details"
    ftType="datetime" ftToggleOffDateTime="true" ftlabel="Some Date" />

Formtool Metadata

Name	datetime
Package Path	farcry.core.packages.formtools.datetime

Attributes

Name	Default	Options	Required	Hint
ftAjaxMethod			No	The function that will be used to render the html output for ajax requests of a property
ftCFDateFormatMask	d mmm yyyy		No	The format mask used when first rendering the date. This should be a coldfusion dateformat mask.
ftClass			No	CSS Class that can be used on the formtool input
ftDateFormatMask	dd mmmm yyyy		No	Coldfusion mask for date for edit handler
ftDateMask	d-mmm-yy		No	Coldfusion date mask for display handler.
ftDisplayMethod			No	The function that will be used to render the html output for displaying a property
ftDisplayPrettyDate	true		No	Converts SQL dateTime value to human readable string
ftEditMethod			No	The function that will be used to render the html output for editing a property
ftEndYear			No	Used when ftRenderType is set to dropDown,, sets the value of the last year in year range.
ftEndYearShift	-100		No	Used when ftRenderType is set to dropDown, sets end of year range in select list.
ftFieldset			No	Used if you are relying on the framework to render your form. Used to group the fields into HTML fieldsets.
ftJQDateFormatMask	d M yy		No	The format mask used by the jQuery UI when returning a date from the calendar. For a full list of the possible formats see http://docs.jquery.com/UI/Datepicker/formatDate
ftLabel			No	Used by the FarCry form layout as the label of the form field. This will default to the [name].
ftLabelAlignment	inline	inline, block	No	Used by FarCry Form Layouts for positioning of labels. inline or block.
ftRenderType	jquery		No	This formtool offers a number of ways to render the input. (dropdown, jquery, dateJS)
ftSeq			No	Used if you are relying on the framework to render your form. Used to sort the fields on the form.
ftShowTime	true		No	Display time portion of dateTime field.
ftStartYear			No	Used when ftRenderType is set to dropDown, sets the value of the first year in year range.
ftStartYearShift	0		No	Used when ftRenderType is set to dropDown, sets start of year range in select list.
ftStyle			No	CSS Style that can be used on the formtool input
ftTimeMask	short		No	Coldfusion time mask for display handler.
ftToggleOffDateTime	false		No	Provides an optional toggle to hide the date if its not required
ftType			No	Tells the framework which of the formtool ui components to use when rendering your form. This will default to the [type].
ftValidateMethod			No	The function that will be used to render the html output for validating (processing) a property form submission
ftValidation			No	List of CSS classes that can be used for js validation
ftWizardStep			No	Used if you are relying on the framework to render your form. Used to setup a wizard which is a multi step form process.