Editing Time field

{{fieldtypes}}


== Description ==
This field is very similar to [[date field]] but allows the inclusion of hours, mintues and seconds. It is used for the various timestamps associated with an eprint record.

Times are always stored in UTC and rendered in the local timezone.

== Inheritance ==
* [[Metadata]]
** [[Date field]]
*** [[Time field]]

== Additional Properties ==
Same as [[Date field#Additional_Properties|Date fields]] except for

{| border="1" cellpadding="3" cellspacing="0"
! Name !! Default Value !! Required? !! Description !! Notes
|-
| '''min_resolution''' || <tt>second</tt> || NO || Indicates the smallest unit of measure that must be entered to make a value valid. Can be <tt>second</tt>, <tt>minute</tt>, <tt>hour</tt>, <tt>day</tt> <tt>month</tt> or <tt>year</tt>. || Different from [[Date field]] default (<tt>day</tt>). E.g. <tt>day</tt> indicates <tt>year</tt>, <tt>month</tt> and <tt>day</tt> are required and <tt>hour</tt>, <tt>minute</tt> and <tt>second</tt> are optional.
|-
| '''render_res''' || <tt>second</tt> || NO || Indicates the smallest unit of time that should be rendered for the value. an be <tt>second</tt>, <tt>minute</tt>, <tt>hour</tt>, <tt>day</tt> <tt>month</tt> or <tt>year</tt>. || Different from [[Date field]] default (<tt>day</tt>). This is not too useful in configuring the field, but can be set as a print option inside citation files. Although it can be handy to store the time right down to the second, you often will just want to render the hours and minutes for day to day use.
|-
| '''render_style''' || <tt>long</tt> || NO || Whether to render time in <tt>long</tt> or <tt>short</tt> format. || Same default value as [[Date field]].  However, if <tt>long</tt> then renders like <tt>8 September 1998 23:12:11 +01:00</tt>. If <tt>short</tt> then renders like <tt>08 Sep 1998 23:12:11</tt>.
|}

== Required Phrases ==
No additional phrases beyond those required for [[Date field#Required_Phrases|Date fields]].

== Database ==
 fieldname_year SMALLINT(6)
 fieldname_month SMALLINT(6)
 fieldname_day SMALLINT(6) 
 fieldname_hour SMALLINT(6)
 fieldname_minute SMALLINT(6)
 fieldname_second SMALLINT(6)

== API ==
See [[API:EPrints/MetaField/Time|API page]].

== Examples ==
Most basic example.
 {
     name => 'timestamp',
     type => 'time',
 }
Only render valyes down to the nearest minute.
 { 
     name => 'datestamp',
     type => 'time',
     render_res => 'minute',
 }
Render date and time in short form.
 {
     name => 'timestamp',
     type => 'time',
     render_style => 'short',
 }
Render date and time in short form.
 {
     name => 'datestamp',
     type => 'time',
     render_style => 'short',
 }
Require minimum resolution to be to the hour.
 {
     name => 'timestamp',
     typ e=> 'time',
     min_resolution => 'hour',
 }