glenn 01/07/07 13:40:25
Added: datetime/xml datetime.xml
Log:
Switch to new build
Revision Changes Path
1.1 jakarta-taglibs/datetime/xml/datetime.xml
Index: datetime.xml
===================================================================
<?xml version="1.0" ?>
<!-- Change all instances of datetime with the jakarta-taglib
name for this tag library.
Change all instances of Datetime with the name to use
for things such as titles in the tag library documentation.
Change <prefix>foo</prefix> below to a short prefix for this
tag library.
-->
<document url="./datetime.xml">
<!-- More properties can be added. Good place to stick loose
data needed elsewhere. -->
<properties>
<!-- The title here overrides the title generated by the
stylesheet for the documentation HTML <title> tag
<title>Jakarta Project: Datetime JSP Tag Library</title>
-->
<!-- The name here is used in the HTML <meta name="author"...> tag -->
<author>Glenn Nielsen</author>
</properties>
<!-- The following defines elements uses both to create the taglib
documentation and the tag library descriptor .tld file. The
elements used are those from the JSP 1.2 TLD DTD and special
elements used when creating the tagib documentation. Although
the JSP1.2 TLD DTD is used, this document can be used to
generate both a JSP 1.1 and a JSP 1.2 TLD.
-->
<taglib>
<!-- The following elements are from the JSP 1.2 TLD DTD -->
<!-- Version number of this tagib -->
<tlib-version>1.0</tlib-version>
<!-- Minimum version of JSP spec required -->
<jsp-version>1.1</jsp-version>
<!-- jakarta-taglib name of this tag library -->
<short-name>datetime</short-name>
<!-- URI of taglib -->
<uri>http://jakarta.apache.org/taglibs/datetime-1.0</uri>
<!-- The name to use in titles, etc. for the taglib -->
<display-name>Datetime Tag Library (Pre Beta)</display-name>
<!-- JSP 1.2 tag library DTD only, not used for generating
documentation.
<small-icon></small-icon>
<large-icon></large-icon>
-->
<!-- Used for generating Overview section of HTML documentation
and for the description element for a JSP 1.2 TLD.
Enter information here as straight XHTML paragraphs. Inside the
paragraphs regular XHTML can be used (but an external CSS is
encouraged). The information is copied into the generated HTML doc,
and the <p> elements are essential for that. -->
<description>
<p>
The DATETIME custom tag library contains tags which can be used to handle
date and time related functions.
</p>
<p>
Tags are provided for formatting a Date for output, generating a Date from
HTML forum input, using time zones, and localization.
</p>
</description>
<!-- The taglib-location is used to fill in the web.xml configuration
information in the HTML doc. -->
<taglib-location>/WEB-INF/datetime.tld</taglib-location>
<!-- The prefix is used to fill in the taglib directive
configuration information in the HTML doc. -->
<prefix>dt</prefix>
<!-- This element must be straight text and is copied right into
the "Requirements" section of the HTML doc. -->
<requirements-info>
This custom tag library requires no software other than a servlet container
that supports the JavaServer Pages Specification, version 1.1 or higher.
</requirements-info>
<toc href="pattern" name="Date Time Pattern Format">
<p>
To specify the time format use a <em>time pattern</em> string.
In this pattern, all ASCII letters are reserved as pattern letters,
which are defined as the following:
<pre>
Symbol Meaning Presentation Example
------ ------- ------------ -------
G era designator (Text) AD
y year (Number) 1996
M month in year (Text & Number) July & 07
d day in month (Number) 10
h hour in am/pm (1~12) (Number) 12
H hour in day (0~23) (Number) 0
m minute in hour (Number) 30
s second in minute (Number) 55
S millisecond (Number) 978
E day in week (Text) Tuesday
D day in year (Number) 189
F day of week in month (Number) 2 (2nd Wed in July)
w week in year (Number) 27
W week in month (Number) 2
a am/pm marker (Text) PM
k hour in day (1~24) (Number) 24
K hour in am/pm (0~11) (Number) 0
z time zone (Text) Pacific Standard Time
' escape for text (Delimiter)
'' single quote (Literal) '
</pre>
The count of pattern letters determine the format.</p>
<p>
<strong>(Text)</strong>: 4 or more pattern letters--use full form,
< 4--use short or abbreviated form if one exists.</p>
<p>
<strong>(Number)</strong>: the minimum number of digits. Shorter
numbers are zero-padded to this amount. Year is handled specially;
that is, if the count of 'y' is 2, the Year will be truncated to 2 digits.</p>
<p>
<strong>(Text & Number)</strong>: 3 or over, use text, otherwise use number.
</p>
<p>
Any characters in the pattern that are not in the ranges of ['a'..'z']
and ['A'..'Z'] will be treated as quoted text. For instance, characters
like ':', '.', ' ', '#' and '@' will appear in the resulting time text
even they are not embraced within single quotes.</p>
<p>
A pattern containing any invalid pattern letter will result in a thrown
exception during formatting or parsing.</p>
<p>
<strong>Examples Using the US Locale:</strong>
<pre>
Format Pattern Result
-------------- -------
"yyyy.MM.dd G 'at' hh:mm:ss z" 1996.07.10 AD at 15:08:56 PDT
"EEE, MMM d, ''yy" Wed, July 10, '96
"h:mm a" 12:08 PM
"hh 'o''clock' a, zzzz" 12 o'clock PM, Pacific Daylight Time
"K:mm a, z" 0:00 PM, PST
"yyyyy.MMMMM.dd GGG hh:mm aaa" 1996.July.10 AD 12:08 PM
</pre>
</p>
</toc>
<!-- The tagtoc element provides the ability to categorize the
tags in the tag library. There must be at least one tagtoc.
1 .. N tags can be nested within a tagtoc.
-->
<tagtoc name="Date Tags">
<tag>
<name>currentTime</name>
<tag-class>org.apache.taglibs.datetime.CurrentTimeTag</tag-class>
<body-content>empty</body-content>
<display-name>currentTime</display-name>
<!-- Complete description of this tag. Used for JSP 1.2 TLD
and for generating HTML documentation. -->
<description>
Gets the current time in milliseconds since Jan 1, 1970 GMT.
</description>
<!-- The next three non-standard elements are used to inform the relevant
sections of the HTML doc. See, for example, the Regexp
taglib docs for examples of the output. -->
<!-- One line summary of what tag does for Tag Summary section -->
<summary>
Gets the current time in milliseconds since Jan 1, 1970 GMT.
</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>None</restrictions>
<!-- The entire example section is for usage examples that you want to
have added to the HTML doc under "Example" for each tag. The
example section is also included with a JSP 1.2 TLD. The
contents of these elements are rendered into a simple form of
syntax highlighting by the XSL sheet. Multiple usage sections
are allowed, and each will be display as a separate example
in the resultant HTML. -->
<example>
<usage>
<comment>
Display the current time
</comment>
<code>
<![CDATA[
The current time in milliseconds since midnight January 1, 1970 GMT is:
<dt:currentTime/>
]]>
</code>
</usage>
</example>
</tag>
<tag>
<name>format</name>
<tag-class>org.apache.taglibs.datetime.FormatTag</tag-class>
<body-content>JSP</body-content>
<display-name>format</display-name>
<!-- Complete description of this tag. Used for JSP 1.2 TLD
and for generating HTML documentation. -->
<description>
Formats a date in milliseconds since Jan 1, 1970 GMT for output
as a date string.
</description>
<!-- The next three non-standard elements are used to inform the relevant
sections of the HTML doc. See, for example, the Regexp
taglib docs for examples of the output. -->
<!-- One line summary of what tag does for Tag Summary section -->
<summary>
Formats a date in milliseconds since Jan 1, 1970 GMT for output
as a date string.
</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>
The body of the tag must be a Date in milliseconds since
Jan 1, 1970 GMT.
</restrictions>
<attribute>
<name>pattern</name>
<required>no</required>
<rtexprvalue>no</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
<a href="#pattern">Date Time Pattern Format</a>
string to use for formatting the date.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<attribute>
<name>timeZone</name>
<required>no</required>
<rtexprvalue>no</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
Name of a timeZone script id variable. Date formatting is
adjusted for the time zone.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<attribute>
<name>date</name>
<required>no</required>
<rtexprvalue>yes</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
Set the date to format by passing in a Date object
using a runtime expression value.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<attribute>
<name>default</name>
<required>no</required>
<rtexprvalue>no</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
Set the default text to output if their is not
a valid date input as a date object or in the tag body.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<attribute>
<name>locale</name>
<required>no</required>
<rtexprvalue>no</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
Set to "<b>true</b>" to use the clients locale,
if known, when formatting date.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<!-- The entire example section is for usage examples that you want to
have added to the HTML doc under "Example" for each tag. The
example section is also included with a JSP 1.2 TLD. The
contents of these elements are rendered into a simple form of
syntax highlighting by the XSL sheet. Multiple usage sections
are allowed, and each will be display as a separate example
in the resultant HTML. -->
<example>
<usage>
<comment>
Display the current time formatted
</comment>
<code>
<![CDATA[
The current time is:
<dt:format pattern="MM/dd/yyyy hh:mm"><dt:currentTime/></dt:format>
]]>
</code>
</usage>
</example>
</tag>
<tag>
<name>parse</name>
<tag-class>org.apache.taglibs.datetime.ParseTag</tag-class>
<body-content>JSP</body-content>
<display-name>parse</display-name>
<!-- Complete description of this tag. Used for JSP 1.2 TLD
and for generating HTML documentation. -->
<description>
Parses a date string and outputs the time in milliseconds since
Jan 1, 1970 GMT.
</description>
<!-- The next three non-standard elements are used to inform the relevant
sections of the HTML doc. See, for example, the Regexp
taglib docs for examples of the output. -->
<!-- One line summary of what tag does for Tag Summary section -->
<summary>
Parses a date string and outputs the time in milliseconds since
Jan 1, 1970 GMT.
</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>
The body of the tag is used as the Date string to parse.
</restrictions>
<attribute>
<name>pattern</name>
<required>no</required>
<rtexprvalue>no</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
<a href="#pattern">Date Time Pattern Format</a>
string to use when parsing the date string.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<attribute>
<name>timeZone</name>
<required>no</required>
<rtexprvalue>no</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
Name of a timeZone script id variable. The date is
adjusted for the time zone.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<attribute>
<name>locale</name>
<required>no</required>
<rtexprvalue>no</rtexprvalue>
<!-- Used for JSP 1.2 TLD and generating HTML docs -->
<description>
Set to "<b>true</b>" to use the clients locale,
if known, when formatting date.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this attribute became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</attribute>
<!-- The entire example section is for usage examples that you want to
have added to the HTML doc under "Example" for each tag. The
example section is also included with a JSP 1.2 TLD. The
contents of these elements are rendered into a simple form of
syntax highlighting by the XSL sheet. Multiple usage sections
are allowed, and each will be display as a separate example
in the resultant HTML. -->
<example>
<usage>
<comment>
Output the date in milliseconds for a specific
day, month, and year
</comment>
<code>
<![CDATA[
<dt:parse pattern="yyyy MM dd">2000 11 5</dt:parse>
]]>
</code>
</usage>
</example>
</tag>
<tag>
<name>timeZone</name>
<tag-class>org.apache.taglibs.datetime.TimeZoneTag</tag-class>
<body-content>JSP</body-content>
<display-name>timeZone</display-name>
<!-- Complete description of this tag. Used for JSP 1.2 TLD
and for generating HTML documentation. -->
<description>
Create a time zone script variable for use with the parse or
format tags.
</description>
<!-- The next three non-standard elements are used to inform the relevant
sections of the HTML doc. See, for example, the Regexp
taglib docs for examples of the output. -->
<!-- One line summary of what tag does for Tag Summary section -->
<summary>
Create a time zone script variable for use with the parse or
format tags.
</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>
The body of the tag must be empty or a valid time zone ID.
If a valid time zone ID is not found, the default time zone for the
server is used.
</restrictions>
<!-- Declaration of scripting variables created by tag.
Used for generating HTML documentation and for
JSP 1.2 DTD. -->
<variable>
<!-- name-given or name-from-attribute must be declared
<name-given>foo</name-given>
-->
<name-from-attribute>id</name-from-attribute>
<!-- Optional variable declarations -->
<!-- Package and class name of variable, default java.lang.String -->
<variable-class>java.util.TimeZone</variable-class>
<!-- Usage for declare is not clear in JSP1.2PFD, default true -->
<declare>true</declare>
<!-- scope of scripting variable, default NESTED -->
<scope>AT_END</scope>
<!-- description of scripting variable -->
<description>
A TimeZone for use with <b>parse</b> and <b>format</b> tags.
</description>
<!-- Used for the HTML documentation only.
Version of taglib when this script variable became available,
deprecated is a possible value. -->
<availability>1.0</availability>
</variable>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
<description>
Script variable id of the time zone for use with the
<b>parse</b> and <b>format</b> tags.
</description>
<availability>1.0</availability>
</attribute>
<!-- The entire example section is for usage examples that you want to
have added to the HTML doc under "Example" for each tag. The
example section is also included with a JSP 1.2 TLD. The
contents of these elements are rendered into a simple form of
syntax highlighting by the XSL sheet. Multiple usage sections
are allowed, and each will be display as a separate example
in the resultant HTML. -->
<example>
<usage>
<comment>
Sets the time zone to America/Chicago
</comment>
<code>
<![CDATA[
<dt:timeZone id="tz">America/Chicago</dt:timeZone>
The current time in America/Chicago is:
<dt:format timeZone="tz"><dt:currentTime/></dt:format>
]]>
</code>
</usage>
</example>
</tag>
</tagtoc>
<tagtoc name="Localized Date Selections">
<tag>
<name>timeZones</name>
<tag-class>org.apache.taglibs.datetime.TimeZonesTag</tag-class>
<tag-class>org.apache.taglibs.datetime.TimeZonesTEI</tag-class>
<body-content>JSP</body-content>
<display-name>timeZones</display-name>
<description>
Loop through all time zones.
</description>
<!-- One line summary of what tag does for Tag Summary section -->
<summary>Loop through all time zones.</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>None</restrictions>
<variable>
<!-- name-given or name-from-attribute must be declared
<name-given>foo</name-given>
-->
<name-from-attribute>id</name-from-attribute>
<!-- Optional variable declarations -->
<!-- Package and class name of variable, default java.lang.String -->
<variable-class>org.apache.taglibs.datetime.TimeZonesTag</variable-class>
<!-- Usage for declare is not clear in JSP1.2PFD, default true -->
<declare>true</declare>
<!-- scope of scripting variable, default NESTED -->
<scope>NESTED</scope>
<!-- description of scripting variable -->
<description>TimeZones Bean</description>
<!-- Used for the HTML documentation only.
Version of taglib when this script variable became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- If the tag creates a script variable or attribute which
is a bean, the following declarations can be used to generate
HTML documentation for 0 .. N properties. -->
<beanprop>
<name>zoneId</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the current time zone ID.
</description>
<availability>1.0</availability>
</beanprop>
<beanprop>
<name>displayName</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the current time zone display name.
</description>
<availability>1.0</availability>
</beanprop>
</variable>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
<description>
Script variable id for use with standard <b>jsp:getProperty</b>
tag.
</description>
<availability>1.0</availability>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
Set to "<b>true</b>" to use the clients locale, if known,
when formatting time zone display names.
</description>
<availability>1.0</availability>
</attribute>
<attribute>
<name>style</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
Style of display name, either "<b>SHORT</b>" or "<b>LONG</b>".
</description>
<availability>1.0</availability>
</attribute>
<example>
<usage>
<comment>
Generate a time zone select box
</comment>
<code>
<![CDATA[
Select a Time Zone
<select name="timeZone">
<dt:timeZones id="tz">
<option value="<jsp:getProperty name="tz" property="zoneId"/>">
<jsp:getProperty name="tz" property="zoneId"/>
<jsp:getProperty name="tz" property="displayName"/>
</dt:timeZones>
</select>
]]>
</code>
</usage>
</example>
</tag>
<tag>
<name>months</name>
<tag-class>org.apache.taglibs.datetime.MonthsTag</tag-class>
<tag-class>org.apache.taglibs.datetime.MonthsTEI</tag-class>
<body-content>JSP</body-content>
<display-name>months</display-name>
<description>
Loop through the months of the year.
</description>
<!-- One line summary of what tag does for Tag Summary section -->
<summary>Loop through the months of the year.</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>None</restrictions>
<variable>
<name-from-attribute>id</name-from-attribute>
<!-- Optional variable declarations -->
<!-- Package and class name of variable, default java.lang.String -->
<variable-class>org.apache.taglibs.datetime.MonthsTag</variable-class>
<!-- Usage for declare is not clear in JSP1.2PFD, default true -->
<declare>true</declare>
<!-- scope of scripting variable, default NESTED -->
<scope>NESTED</scope>
<!-- description of scripting variable -->
<description>Months of the year Bean</description>
<!-- Used for the HTML documentation only.
Version of taglib when this script variable became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<beanprop>
<name>monthOfYear</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the number of the month of the year.
</description>
<availability>1.0</availability>
</beanprop>
<beanprop>
<name>month</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the full name of the month of the year.
</description>
<availability>1.0</availability>
</beanprop>
<beanprop>
<name>shortMonth</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the short name of the month of the year.
</description>
<availability>1.0</availability>
</beanprop>
</variable>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
<description>
Script variable id for use with standard <b>jsp:getProperty</b>
tag.
</description>
<availability>1.0</availability>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
Set to "<b>true</b>" to use the clients locale, if known,
when listing the month names.
</description>
<availability>1.0</availability>
</attribute>
<example>
<usage>
<comment>
Generate a Month select box
</comment>
<code>
<![CDATA[
Select a Month
<select name="month">
<dt:months id="mon">
<option value="<jsp:getProperty name="mon" property="monthOfYear"/>">
<jsp:getProperty name="mon" property="month"/>
</dt:months>
</select>
]]>
</code>
</usage>
</example>
</tag>
<tag>
<name>weekdays</name>
<tag-class>org.apache.taglibs.datetime.WeekdaysTag</tag-class>
<tag-class>org.apache.taglibs.datetime.WeekdaysTEI</tag-class>
<body-content>JSP</body-content>
<display-name>weekdays</display-name>
<description>
Loop through the days of the week.
</description>
<!-- One line summary of what tag does for Tag Summary section -->
<summary>Loop through the days of the week.</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>None</restrictions>
<variable>
<name-from-attribute>id</name-from-attribute>
<!-- Optional variable declarations -->
<!-- Package and class name of variable, default java.lang.String -->
<variable-class>org.apache.taglibs.datetime.WeekdaysTag</variable-class>
<!-- Usage for declare is not clear in JSP1.2PFD, default true -->
<declare>true</declare>
<!-- scope of scripting variable, default NESTED -->
<scope>NESTED</scope>
<!-- description of scripting variable -->
<description>Days of the week Bean</description>
<!-- Used for the HTML documentation only.
Version of taglib when this script variable became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<beanprop>
<name>dayOfWeek</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the number of the day of the week.
</description>
<availability>1.0</availability>
</beanprop>
<beanprop>
<name>weekday</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the full name of the day of the week.
</description>
<availability>1.0</availability>
</beanprop>
<beanprop>
<name>shortWeekday</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the short name of the day of the week.
</description>
<availability>1.0</availability>
</beanprop>
</variable>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
<description>
Script variable id for use with standard <b>jsp:getProperty</b>
tag.
</description>
<availability>1.0</availability>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
Set to "<b>true</b>" to use the clients locale, if known,
when listing the week day names.
</description>
<availability>1.0</availability>
</attribute>
<example>
<usage>
<comment>
Generate a Week Day select box
</comment>
<code>
<![CDATA[
Select a Week Day
<select name="weekday">
<dt:weekdays id="day">
<option value="<jsp:getProperty name="day" property="dayOfWeek"/>">
<jsp:getProperty name="day" property="weekday"/>
</dt:weekdays>
</select>
]]>
</code>
</usage>
</example>
</tag>
<tag>
<name>amPms</name>
<tag-class>org.apache.taglibs.datetime.AmPmsTag</tag-class>
<tag-class>org.apache.taglibs.datetime.AmPmsTEI</tag-class>
<body-content>JSP</body-content>
<display-name>amPms</display-name>
<description>
Loop through the am/pm names.
</description>
<!-- One line summary of what tag does for Tag Summary section -->
<summary>>Loop through the am/pm names.</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>None</restrictions>
<variable>
<name-from-attribute>id</name-from-attribute>
<!-- Optional variable declarations -->
<!-- Package and class name of variable, default java.lang.String -->
<variable-class>org.apache.taglibs.datetime.AmPmsTag</variable-class>
<!-- Usage for declare is not clear in JSP1.2PFD, default true -->
<declare>true</declare>
<!-- scope of scripting variable, default NESTED -->
<scope>NESTED</scope>
<!-- description of scripting variable -->
<description>Am/Pm names Bean</description>
<!-- Used for the HTML documentation only.
Version of taglib when this script variable became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<beanprop>
<name>name</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the am/pm name.
</description>
<availability>1.0</availability>
</beanprop>
</variable>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
<description>
Script variable id for use with standard <b>jsp:getProperty</b>
tag.
</description>
<availability>1.0</availability>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
Set to "<b>true</b>" to use the clients locale, if known,
when listing the am/pm names.
</description>
<availability>1.0</availability>
</attribute>
<example>
<usage>
<comment>
Generate an am/pm select box
</comment>
<code>
<![CDATA[
Select AM or PM:
<select name="ampm">
<dt:ampms id="ap">
<option value="<jsp:getProperty name="ap" property="name"/>">
<jsp:getProperty name="ap" property="name"/>
</dt:ampms>
</select>
]]>
</code>
</usage>
</example>
</tag>
<tag>
<name>eras</name>
<tag-class>org.apache.taglibs.datetime.ErasTag</tag-class>
<tag-class>org.apache.taglibs.datetime.ErasTEI</tag-class>
<body-content>JSP</body-content>
<display-name>eras</display-name>
<description>
Loop through the era names.
</description>
<!-- One line summary of what tag does for Tag Summary section -->
<summary>>Loop through the era names.</summary>
<!-- Version of taglib when this tag became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<!-- Any restrictions on use of the tag -->
<restrictions>None</restrictions>
<variable>
<name-from-attribute>id</name-from-attribute>
<!-- Optional variable declarations -->
<!-- Package and class name of variable, default java.lang.String -->
<variable-class>org.apache.taglibs.datetime.ErasTag</variable-class>
<!-- Usage for declare is not clear in JSP1.2PFD, default true -->
<declare>true</declare>
<!-- scope of scripting variable, default NESTED -->
<scope>NESTED</scope>
<!-- description of scripting variable -->
<description>Era names Bean</description>
<!-- Used for the HTML documentation only.
Version of taglib when this script variable became available,
deprecated is a possible value. -->
<availability>1.0</availability>
<beanprop>
<name>name</name>
<get>Yes</get>
<set>No</set>
<description>
Returns the era name.
</description>
<availability>1.0</availability>
</beanprop>
</variable>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
<description>
Script variable id for use with standard <b>jsp:getProperty</b>
tag.
</description>
<availability>1.0</availability>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
Set to "<b>true</b>" to use the clients locale, if known,
when listing the era names.
</description>
<availability>1.0</availability>
</attribute>
<example>
<usage>
<comment>
Generate an era select box
</comment>
<code>
<![CDATA[
Select an Era:
<select name="era">
<dt:era id="era">
<option value="<jsp:getProperty name="era" property="name"/>">
<jsp:getProperty name="era" property="name"/>
</dt:era>
</select>
]]>
</code>
</usage>
</example>
</tag>
</tagtoc>
</taglib>
<revision release="Pre Beta" date="07/07/2001">
<description>
Clean up of tag library prior to performing a beta
release, moving toward an official release.
</description>
<section name="Tag Changes">
<item>
Changed the name of the <b>currentime</b> tag to
<b>currentTime</b>.
</item>
<item>
Changed the name of the <b>timeZone</b> tag to
<b>timeZone</b>.
</item>
<item>
Changed the name of the <b>timezones</b> tag to
<b>timeZones</b>.
</item>
<item>
Changed the name of the <b>ampms</b> tag to
<b>amPms</b>.
</item>
<item>
Changed the name of the <b>parse</b> tag <b>timezone</b>
attribute to <b>timeZone</b>.
</item>
<item>
Changed the name of the <b>format</b> tag <b>timezone</b>
attribute to <b>timeZone</b>.
</item>
</section>
</revision>
<revision release="Development" date="04/26/2001">
<description>
Implementation of some requested changes.
</description>
<section name="New Features">
<item>
Added <b>date</b> and <b>default</b> attributes to the
<b>format</b> tag.
</item>
</section>
<section name="Tag Changes">
<item>
The <b>format</b> tag now ignores any white space in its
tag body.
</item>
</section>
</revision>
<revision release="Development" date="11/05/2000">
<description>
Initial version of tag library before Jakarta-Taglibs
had an official release policy for tag libraries.
</description>
</revision>
</document>
