<html>
<head>
<title>MHonArc Resources: LOCALDATEFMT</title>
<link rel="stylesheet" type="text/css" href="../docstyles.css">
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="litemplate.html">LITEMPLATE</a>]</td><td><nobr>[<a href="../resources.html#localdatefmt">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="lock.html">LOCK</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>LOCALDATEFMT</h1>
<!--X-TOC-Start-->
<ul>
<li><a href="#syntax">Syntax</a>
<li><a href="#description">Description</a>
<li><a href="#default">Default Setting</a>
<li><a href="#rcvars">Resource Variables</a>
<li><a href="#examples">Examples</a>
<li><a href="#version">Version</a>
<li><a href="#seealso">See Also</a>
</ul>
<!--X-TOC-End-->
<!-- *************************************************************** -->
<hr>
<h2><a name="syntax">Syntax</a></h2>
<dl>
<dt><strong>Envariable</strong></dt>
<dd><p>
<code>M2H_LOCALDATEFMT=</code><var>date-format</var>
</p>
</dd>
<dt><strong>Element</strong></dt>
<dd><p>
<code><LOCALDATEFMT><br></code>
<var>date-format</var><br>
<code></LOCALDATEFMT><br></code>
</p>
</dd>
<dt><strong>Command-line Option</strong></dt>
<dd><p>
<code>-localdatefmt </code><var>date-format</var>
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2><a name="description">Description</a></h2>
<p>The LOCALDATEFMT resource specifies the date format for the
<strong><code>$LOCALDATE$</code></strong> resource variable
(i.e. The local system date).
The format is a string containing zero or more conversion
specifications and regular characters. A conversion specification
consists of the '<code><strong>%</strong></code>' character
followed a character that determines the type of conversion.
</p>
<p>The following lists the possible conversion specifications:
</p>
<table border=0 cellpadding=4>
<tr valign=top>
<td><strong>NOTE</strong></td>
<td><p>If <a href="posixstrftime.html">POSIXSTRFTIME</a> is set,
the <b>POSIX::strftime()</b> function will be used. Therefore, there may be
more conversion specifications available. See your system's
<b>strftime()</b> manpage for specifics.
</p>
</td>
</tr>
</table>
<table border=0 cellspacing=1 cellpadding=4>
<tr valign=top>
<th align=right>Spec</th>
<th align=left>Value</th>
</tr>
<tr valign=top>
<td align=right><strong>%%</strong></td>
<td>the % character</td>
</tr>
<tr valign=top>
<td align=right><strong>%a</strong></td>
<td>abbreviated weekday name</td>
</tr>
<tr valign=top>
<td align=right><strong>%A</strong></td>
<td>full weekday name</td>
</tr>
<tr valign=top>
<td align=right><strong>%b</strong></td>
<td>abbreviated month name</td>
</tr>
<tr valign=top>
<td align=right><strong>%B</strong></td>
<td>full month name</td>
</tr>
<tr valign=top>
<td align=right><strong>%c</strong></td>
<td>appropriate date and time representation</td>
</tr>
<tr valign=top>
<td align=right><strong>%d</strong></td>
<td>day of month [1,31]; single digits are preceded by 0</td>
</tr>
<tr valign=top>
<td align=right><strong>%h</strong></td>
<td>abbreviated month name</td>
</tr>
<tr valign=top>
<td align=right><strong>%H</strong></td>
<td>hour (24-hour clock) [0,23]; single digits are preceded by 0</td>
</tr>
<tr valign=top>
<td align=right><strong>%I</strong></td>
<td>hour (12-hour clock) [1,12]; single digits are preceded by 0</td>
</tr>
<tr valign=top>
<td align=right><strong>%j</strong></td>
<td>day number of year [1,366]; single digits are preceded by 0</td>
</tr>
<tr valign=top>
<td align=right><strong>%m</strong></td>
<td>month number [1,12]; single digits are preceded by 0</td>
</tr>
<tr valign=top>
<td align=right><strong>%M</strong></td>
<td>minute[00,59]; single digits are preceded by 0</td>
</tr>
<tr valign=top>
<td align=right><strong>%p</strong></td>
<td>am or pm.</td>
</tr>
<tr valign=top>
<td align=right><strong>%P</strong></td>
<td>AM or PM.</td>
</tr>
<tr valign=top>
<td align=right><strong>%S</strong></td>
<td>seconds [00,61]</td>
</tr>
<tr valign=top>
<td align=right><strong>%w</strong></td>
<td>weekday as a decimal number [0,6], with 0 representing Sunday</td>
</tr>
<tr valign=top>
<td align=right><strong>%y</strong></td>
<td>year within century [00,99]</td>
</tr>
<tr valign=top>
<td align=right><strong>%Y</strong></td>
<td>year, including the century (for example 1993)</td>
</tr>
</table>
<p>Setting LOCALDATEFMT to a blank string will reset the resource
to the default setting.
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="default">Default Setting</a></h2>
<pre>
%a %b %d %H:%M:%S %Y
</pre>
<!-- *************************************************************** -->
<hr>
<h2><a name="rcvars">Resource Variables</a></h2>
<p>N/A
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="examples">Examples</a></h2>
<p>The following sets the local date to use the long weekday and
month names and 12 hour am/pm time:
</p>
<pre>
<b><LocalDateFmt></b>
%A %B %d %I:%M:%S %p %y
<b></LocalDateFmt></b>
</pre>
<!-- *************************************************************** -->
<hr>
<h2><a name="version">Version</a></h2>
<p>2.0
</p>
<!-- *************************************************************** -->
<hr>
<h2><a name="seealso">See Also</a></h2>
<p>
<a href="gmtdatefmt.html">GMTDATEFMT</a>,
<a href="months.html">MONTHS</a>,
<a href="monthsabr.html">MONTHSABR</a>,
<a href="msggmtdatefmt.html">MSGGMTDATEFMT</a>,
<a href="msglocaldatefmt.html">MSGLOCALDATEFMT</a>,
<a href="posixstrftime.html">POSIXSTRFTIME</a>,
<a href="weekdays.html">WEEKDAYS</a>,
<a href="weekdaysabr.html">WEEKDAYSABR</a>
</p>
<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev: <a href="litemplate.html">LITEMPLATE</a>]</td><td><nobr>[<a href="../resources.html#localdatefmt">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="lock.html">LOCK</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2003/10/06 22:04:17 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright © 1997-1999, <a href="http://www.earlhood.com/">Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org">mhonarc<!--
-->@<!--
-->mhonarc.org</a><br>
</address>
</body>
</html>