161 lines
7.5 KiB
HTML
161 lines
7.5 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type"
|
||
|
|
content="text/html; charset=iso-8859-1">
|
||
|
|
<meta name="GENERATOR"
|
||
|
|
content="Mozilla/4.8 [en] (X11; U; Linux 2.4.18-27.7.xsmp i686) [Netscape]">
|
||
|
|
<title>Text Products Reference</title>
|
||
|
|
<!--link REL="STYLESHEET" HREF="TextFormatter.html"-->
|
||
|
|
</head>
|
||
|
|
<body bgcolor="#ffffff">
|
||
|
|
<center>
|
||
|
|
<h1><a name="TextProductCreationUser"></a>Text Product Creation User
|
||
|
|
Guide</h1></center><p>
|
||
|
|
<a href="#Time_Display_Formats">Time Display Formats</a>
|
||
|
|
<hr>
|
||
|
|
<h2 class="2Heading"> <a name="Time_Display_Formats"></a>Time Display
|
||
|
|
Formats</h2>
|
||
|
|
The display format for the time period in text or period labels for
|
||
|
|
Simple Tabular products may be specified in the product Definition as
|
||
|
|
"timePeriodFormat" or "periodLabelFormat",
|
||
|
|
respectively. Also, Smart Text products have access
|
||
|
|
to
|
||
|
|
various TimeDescriptor methods such as "getCurrentTime" which use the
|
||
|
|
same "formatting entries" shown below. The general form is a tuple
|
||
|
|
containing the following:
|
||
|
|
<p>(LTorZulu, durationFormat, startFormat, endFormat) </p>
|
||
|
|
<p> If LTorZulu is set to "LT", the time period will be reported
|
||
|
|
in local time instead of GMT. By setting a format string to "", that
|
||
|
|
value is not output. The formatting entries consist of a keyword
|
||
|
|
prefixed with an '%'. The software will substitute the appropriate
|
||
|
|
value in place of the %keyword in the format string. To add extra
|
||
|
|
characters, such as spaces or some text (e.g., "to"), simply add those
|
||
|
|
characters to the format. For example, this timePeriodFormat: </p>
|
||
|
|
<p> "timePeriodFormat": ("LT", "%H hours
|
||
|
|
", "%a %b %d, %Y %I:%M %p", " to %a %b %d, %Y %I:%M %p %Z"), </p>
|
||
|
|
<p>will yield a time period display such as: </p>
|
||
|
|
<p> 12 hours Mon Apr 23, 2001
|
||
|
|
06:00 AM to Mon Apr 23, 2001 06:00 PM MDT. </p>
|
||
|
|
<p><span style="font-weight: bold;">Formatting Entries:</span>
|
||
|
|
The following list specifies the acceptable formatting entries that are
|
||
|
|
allowed: </p>
|
||
|
|
<p>
|
||
|
|
%a Locale's abbreviated
|
||
|
|
weekday name. <br>
|
||
|
|
|
||
|
|
%A Locale's full weekday
|
||
|
|
name. <br>
|
||
|
|
|
||
|
|
%b Locale's abbreviated month
|
||
|
|
name. <br>
|
||
|
|
|
||
|
|
%B Locale's full month name. <br>
|
||
|
|
|
||
|
|
%c Locale's appropriate date
|
||
|
|
and time representation. <br>
|
||
|
|
|
||
|
|
%C The century number (the
|
||
|
|
year divided by 100 and truncated to an integer) as a decimal number
|
||
|
|
[00-99]. <br>
|
||
|
|
|
||
|
|
%d Day of the month as a
|
||
|
|
decimal number [01,31]. <br>
|
||
|
|
|
||
|
|
%D Equivalent to the
|
||
|
|
directive
|
||
|
|
string %m/%d/%y. <br>
|
||
|
|
|
||
|
|
%e Day of the month as a
|
||
|
|
decimal number [1,31]; a single <br>
|
||
|
|
|
||
|
|
digit is preceded by a space. <br>
|
||
|
|
|
||
|
|
%h Equivalent to %b. <br>
|
||
|
|
|
||
|
|
%H Hour (24-hour clock) as a
|
||
|
|
decimal number [00,23]. <br>
|
||
|
|
|
||
|
|
%I Hour (12-hour clock) as a
|
||
|
|
decimal number [01,12]. <br>
|
||
|
|
|
||
|
|
%j Day of the year as a
|
||
|
|
decimal number [001,366]. <br>
|
||
|
|
|
||
|
|
%m Month as a decimal number
|
||
|
|
[01,12]. <br>
|
||
|
|
|
||
|
|
%M Minute as a decimal number
|
||
|
|
[00,59]. <br>
|
||
|
|
|
||
|
|
%n The New-line character. <br>
|
||
|
|
|
||
|
|
%p Locale's equivalent of
|
||
|
|
either AM or PM. <br>
|
||
|
|
|
||
|
|
%r The time in AM and PM
|
||
|
|
notation; in the POSIX locale this is equivalent to %I:%M:%S %p. <br>
|
||
|
|
|
||
|
|
%R The time in 24 hour
|
||
|
|
notation (%H:%M). <br>
|
||
|
|
|
||
|
|
%S Second as a decimal number
|
||
|
|
[00,61]. <br>
|
||
|
|
|
||
|
|
%t The Tab character. <br>
|
||
|
|
|
||
|
|
%T The time in hours,
|
||
|
|
minutes,
|
||
|
|
and seconds (%H:%M:%S). <br>
|
||
|
|
|
||
|
|
%u The weekday as a decimal
|
||
|
|
number [1(Monday),7]. <br>
|
||
|
|
|
||
|
|
%U Week number of the year
|
||
|
|
(Sunday as the first day of the week) as a decimal number
|
||
|
|
[00,53].
|
||
|
|
All days in a new year preceding the <br>
|
||
|
|
|
||
|
|
first Sunday are considered to be in week 0. <br>
|
||
|
|
|
||
|
|
%V The week number of the
|
||
|
|
year
|
||
|
|
(Monday as the first day of the week) as a decimal number
|
||
|
|
[01,53].
|
||
|
|
If the week containing January <br>
|
||
|
|
|
||
|
|
1st has four or more days in the new year, then it is considered
|
||
|
|
week 1; otherwise, it is week 53 of the previous year, and the next
|
||
|
|
week
|
||
|
|
is week 1. <br>
|
||
|
|
|
||
|
|
%w Weekday as a decimal
|
||
|
|
number
|
||
|
|
[0(Sunday),6]. <br>
|
||
|
|
|
||
|
|
%W Week number of the year
|
||
|
|
(Monday as the first day of the week) as a decimal number
|
||
|
|
[00,53].
|
||
|
|
All days in a new year preceding <br>
|
||
|
|
|
||
|
|
the first Monday are considered to be in week 0. <br>
|
||
|
|
|
||
|
|
%x Locale's appropriate date
|
||
|
|
representation. <br>
|
||
|
|
|
||
|
|
%X Locale's appropriate time
|
||
|
|
representation. <br>
|
||
|
|
|
||
|
|
%y Year without century as a
|
||
|
|
decimal number [00,99]. <br>
|
||
|
|
|
||
|
|
%Y Year with century as a
|
||
|
|
decimal number. <br>
|
||
|
|
|
||
|
|
%Z Time zone name (or by no
|
||
|
|
characters if no time zone exists). <br>
|
||
|
|
|
||
|
|
%% The percent (%) character.
|
||
|
|
<br>
|
||
|
|
</p>
|