View source for DateTime Field

[[Category:Fields]]
{{FeatureInfo
|editions=wcm,ecm,comm
|fromversion=6.0
|wikicomplete=100%
|interest=enduser,builder
}}
 
{| style="margin-left:2em;" align="right"
| __TOC__
|}

=Overview=
DateTime is a [[Field]] that stores a date and a time value.

=Details=


==Field handler==
*handler: SenseNet.ContentRepository.Fields.DateTimeField
*short name: '''DateTime'''

Usage in CTD:
<source lang="xml">
   <Field name="CreationDate" type="DateTime">
   ...
   </Field>
</source>

==Supported Field Controls==
*[[DatePicker Field Control]]: a simple grid displaying a clickable calendar in month view
==Configuration==
The following properties can be set in the field's configuration:
*'''DateTimeMode''': (optional) an enumeration which defines the presentation mode of the stored value: ''None'', ''Date'' and ''DateAndTime''. This only controls the behavior of the [[DatePicker Field Control]]. Default is ''None''.
*'''Precision''': (optional) an enumeration which defines the precision of the indexed value: ''Millisecond, Second, Minute, Hour, Day'' (Default is ''Minute''). This does not affect the stored value, only the value stored in the index, making it possible to use different precision levels depending on the nature of the application. Chosing a finer or coarser precision than the optimal may cause slower query running and larger index files than what would be reasonable. Default is ''Minute''.
{{Info|For a complete list of common Field Setting configuration properties see [[Content Type Definition#Field definition|CTD Field definition]].}}

=Example/Tutorials=
Fully featured example:

<source lang="xml">
<Field name="MyDateTimeField" type="DateTime">
	<DisplayName>My DateTime field</DisplayName>
	<Description>DateTime content</Description>
	<Configuration>
		<DateTimeMode>DateAndTime</DateTimeMode>
		<Precision>Second</Precision>
	</Configuration>
</Field>
</source>

The above example configures the DateTime field so that:
*it stores the date and time values
*it stores the date/time in the index in seconds

=Related links=
*[[Field]]
*[[DatePicker Field Control]]

=References=