datetime

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.