Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / resources / localdatefmt.html
CommitLineData
86530b38
AT
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
2<html>
3<head>
4<title>MHonArc Resources: LOCALDATEFMT</title>
5</head>
6<body>
7<!--x-rc-nav-->
8<table border=0><tr valign="top">
9<td align="left" width="50%">[Prev:&nbsp;<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:&nbsp;<a href="lock.html">LOCK</a>]</td></tr></table>
10<!--/x-rc-nav-->
11<hr>
12<h1>LOCALDATEFMT</h1>
13
14<!-- *************************************************************** -->
15<hr>
16<h2>Syntax</h2>
17
18<dl>
19
20<dt><strong>Envariable</strong></dt>
21<dd><p>
22<code>M2H_LOCALDATEFMT=</code><var>date-format</var>
23</p>
24</dd>
25
26<dt><strong>Element</strong></dt>
27<dd><p>
28<code>&lt;LOCALDATEFMT&gt;<br></code>
29<var>date-format</var><br>
30<code>&lt;/LOCALDATEFMT&gt;<br></code>
31</p>
32</dd>
33
34<dt><strong>Command-line Option</strong></dt>
35<dd><p>
36<code>-localdatefmt </code><var>date-format</var>
37</p>
38</dd>
39
40</dl>
41
42<!-- *************************************************************** -->
43<hr>
44<h2>Description</h2>
45
46<p>The LOCALDATEFMT resource specifies the date format for the
47<strong><code>$LOCALDATE$</code></strong> resource variable
48(i.e. The local system date).
49The format is a string containing zero or more conversion
50specifications and regular characters. A conversion specification
51consists of the '<code><strong>%</strong></code>' character
52followed a character that determines the type of conversion.
53</p>
54
55<p>The following lists the possible conversion specifications:
56</p>
57
58<table border=0 cellpadding=4>
59<tr valign=top>
60<td><strong>NOTE</strong></td>
61<td><p>If <a href="posixstrftime.html">POSIXSTRFTIME</a> is set,
62the <b>POSIX::strftime()</b> function will be used. Therefore, there may be
63more conversion specifications available. See your system's
64<b>strftime()</b> manpage for specifics.
65</p>
66</td>
67</tr>
68</table>
69
70<table border=0 cellspacing=1 cellpadding=4>
71<tr valign=top>
72<th align=right>Spec</th>
73<th align=left>Value</th>
74</tr>
75<tr valign=top>
76<td align=right><strong>%%</strong></td>
77<td>the % character</td>
78</tr>
79<tr valign=top>
80<td align=right><strong>%a</strong></td>
81<td>abbreviated weekday name</td>
82</tr>
83<tr valign=top>
84<td align=right><strong>%A</strong></td>
85<td>full weekday name</td>
86</tr>
87<tr valign=top>
88<td align=right><strong>%b</strong></td>
89<td>abbreviated month name</td>
90</tr>
91<tr valign=top>
92<td align=right><strong>%B</strong></td>
93<td>full month name</td>
94</tr>
95<tr valign=top>
96<td align=right><strong>%c</strong></td>
97<td>appropriate date and time representation</td>
98</tr>
99<tr valign=top>
100<td align=right><strong>%d</strong></td>
101<td>day of month [1,31]; single digits are preceded by 0</td>
102</tr>
103<tr valign=top>
104<td align=right><strong>%h</strong></td>
105<td>abbreviated month name</td>
106</tr>
107<tr valign=top>
108<td align=right><strong>%H</strong></td>
109<td>hour (24-hour clock) [0,23]; single digits are preceded by 0</td>
110</tr>
111<tr valign=top>
112<td align=right><strong>%I</strong></td>
113<td>hour (12-hour clock) [1,12]; single digits are preceded by 0</td>
114</tr>
115<tr valign=top>
116<td align=right><strong>%j</strong></td>
117<td>day number of year [1,366]; single digits are preceded by 0</td>
118</tr>
119<tr valign=top>
120<td align=right><strong>%m</strong></td>
121<td>month number [1,12]; single digits are preceded by 0</td>
122</tr>
123<tr valign=top>
124<td align=right><strong>%M</strong></td>
125<td>minute[00,59]; single digits are preceded by 0</td>
126</tr>
127<tr valign=top>
128<td align=right><strong>%p</strong></td>
129<td>am or pm.</td>
130</tr>
131<tr valign=top>
132<td align=right><strong>%P</strong></td>
133<td>AM or PM.</td>
134</tr>
135<tr valign=top>
136<td align=right><strong>%S</strong></td>
137<td>seconds [00,61]</td>
138</tr>
139<tr valign=top>
140<td align=right><strong>%w</strong></td>
141<td>weekday as a decimal number [0,6], with 0 representing Sunday</td>
142</tr>
143<tr valign=top>
144<td align=right><strong>%y</strong></td>
145<td>year within century [00,99]</td>
146</tr>
147<tr valign=top>
148<td align=right><strong>%Y</strong></td>
149<td>year, including the century (for example 1993)</td>
150</tr>
151
152</table>
153
154<p>Setting LOCALDATEFMT to a blank string will reset the resource
155to the default setting.
156</p>
157
158<!-- *************************************************************** -->
159<hr>
160<h2>Default Setting</h2>
161
162<pre>
163%a %b %d %H:%M:%S %Y
164</pre>
165
166<!-- *************************************************************** -->
167<hr>
168<h2>Resource Variables</h2>
169
170<p>N/A
171</p>
172
173<!-- *************************************************************** -->
174<hr>
175<h2>Examples</h2>
176
177<p>The following sets the local date to use the long weekday and
178month names and 12 hour am/pm time:
179</p>
180
181<pre>
182<b>&lt;LocalDateFmt&gt;</b>
183%A %B %d %I:%M:%S %p %y
184<b>&lt;/LocalDateFmt&gt;</b>
185</pre>
186
187
188<!-- *************************************************************** -->
189<hr>
190<h2>Version</h2>
191
192<p>2.0
193</p>
194
195<!-- *************************************************************** -->
196<hr>
197<h2>See Also</h2>
198
199<p>
200<a href="gmtdatefmt.html">GMTDATEFMT</a>,
201<a href="months.html">MONTHS</a>,
202<a href="monthsabr.html">MONTHSABR</a>,
203<a href="msggmtdatefmt.html">MSGGMTDATEFMT</a>,
204<a href="msglocaldatefmt.html">MSGLOCALDATEFMT</a>,
205<a href="posixstrftime.html">POSIXSTRFTIME</a>,
206<a href="weekdays.html">WEEKDAYS</a>,
207<a href="weekdaysabr.html">WEEKDAYSABR</a>
208</p>
209
210<!-- *************************************************************** -->
211<hr>
212<!--x-rc-nav-->
213<table border=0><tr valign="top">
214<td align="left" width="50%">[Prev:&nbsp;<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:&nbsp;<a href="lock.html">LOCK</a>]</td></tr></table>
215<!--/x-rc-nav-->
216<hr>
217<address>
218$Date: 2002/07/27 05:13:10 $ <br>
219<img align="top" src="../monicon.png" alt="">
220<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
221Copyright &#169; 1997-1999, <a href="http://www.earlhood.com/">Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org">mhonarc@mhonarc.org</a><br>
222</address>
223
224</body>
225</html>