date-display.html in Date 7

File

help/date-display.html

<p>The date field can be displayed, or formatted, several ways, some configurable in the date settings, others that are automatically provided as options.</p>
<p>You'll see these formatters as options on the 'Display fields' screen and when you add the fields to Views. You can also use these formatters in custom code by doing something like:</p>
<pre>
print content_format('field_date', $node->field_date[0], 'iso');
</pre>

<h3>Formatter settings</h3>
<p>In many places you can further control the way multiple value dates will be displayed with formatter settings. The formatter settings look like:</p>

<div class="form-item" id="">
 <select name="" class="form-select" id="" ><option value="default" selected="selected">Default</option><option value="format_interval">As Time Ago</option><option value="long">Long</option><option value="medium">Medium</option><option value="short">Short</option><option value="date">Date only</option><option value="time">Time only</option><option value="hidden">&lt;Hidden&gt;</option></select>

</div>
<div class="form-item" id="">
 <select name="" class="form-select" id="" ><option value="both" selected="selected">Display From and To dates</option><option value="value">Display From date only</option><option value="value2">Display To date only</option></select>
</div>
<div class="form-item" id="">
 <span class="field-prefix">Show </span> <input type="text" maxlength="128" name="" id="" size="5" value="5" class="form-text" /> <span class="field-suffix"> value(s)</span>
</div>

<div class="form-item" id="">
 <span class="field-prefix">starting from </span> <input type="text" maxlength="128" name="" id="" size="15" value="now" class="form-text" /> <span class="field-suffix"></span>
</div>
<div class="form-item" id="">
 <span class="field-prefix">ending on </span> <input type="text" maxlength="128" name="" id="" size="15" value="now +2 weeks" class="form-text" /> <span class="field-suffix"></span>
</div>
<div class="form-item" id="">
 <select name="" class="form-select" id="" ><option value="show" selected="selected">Display repeat rule</option><option value="hide">Hide repeat rule</option></select>
</div>

<p>The number of values should be a numeric value, or blank to show all dates that match your other options. 
'Starting from' and 'Ending on' can be a fixed dates in ISO format (like 2009-03-03T10:30:00) or relative times like 'now' or 'now +1 day'.
</p>

<h3>Formats and Format Types</h3>
<p>Formatter options include:</p>
<dl>
<dt>default</dt>
<dd>The main way to display this date, configured in the Date settings, defaults to the site short format.</dd>
<dt>short</dt>
<dd>The site short format.</dd>
<dt>medium</dt>
<dd>The site medium format.</dd>
<dt>long</dt>
<dd>The site long format.</dd>
<dt>time</dt>
<dd>Display the date time only, using the time format in the default display.</dd>
<dt>time_timezone</dt>
<dd>Display the date time and timezone, using the time format in the default display.</dd>
<dt>iso</dt>
<dd>Display the date in the standard ISO format of YYYY-MM-DDTHH:MM:SS.</dd>
<dt>ical</dt>
<dd>Display the date in the standard iCal format of YYYYMMDDTHHMMSS.</dd>
<dt>timestamp</dt>
<dd>Display the date as the Unix timestamp value.</dd>
<dt>format_interval</dt>
<dd>Display the date as 'XX days, XX hours ago' or 'XX months, XX days from now'.</dd>
</dl>
<p> To set up custom formats and formatters, go to <a href="&base_url&admin/config/regional/date-time/formats">admin/config/regional/date-time/formats</a>. You can either use a pre-configured display format, or create your own formatters and formats. Define a php date format string like 'm-d-Y H:i' (see <a href="http://php.net/date">http://php.net/date</a> for more details on custom format strings.)</p>