ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstdftimfm.htm

152 lines
7.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="TIMFMT (Time Format) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword to specify the format of a time field. This keyword is valid for time fields (data type T)." />
<meta name="description" content="Use this field-level keyword to specify the format of a time field. This keyword is valid for time fields (data type T)." />
<meta name="DC.subject" content="TIMFMT (Time Format) keyword, Time Format (TIMFMT) keyword" />
<meta name="keywords" content="TIMFMT (Time Format) keyword, Time Format (TIMFMT) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakcmstdftimfm" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>TIMFMT (Time Format) keyword for display files</title>
</head>
<body id="rzakcmstdftimfm"><a name="rzakcmstdftimfm"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">TIMFMT (Time Format) keyword for display files</h1>
<div><p>Use this field-level keyword to specify the format of a time field.
This keyword is valid for time fields (data type T).</p>
<div class="section"><div class="p">The format of the keyword is: <pre>TIMFMT(time-format)</pre>
</div>
<p>The
following table describes the valid time formats and their default separators.</p>
<table cellpadding="4" cellspacing="0" border="1" class="tableborder"><tr><td>
<table cellpadding="4" cellspacing="0" summary="" width="100%" border="0"><thead align="left"><tr><th align="left" valign="bottom" width="29.797979797979796%" id="d0e33">Format name</th>
<th align="left" valign="bottom" width="18.939393939393938%" id="d0e35">Time format parameter</th>
<th align="left" valign="bottom" width="17.929292929292927%" id="d0e37">Time format and separator</th>
<th align="left" valign="bottom" width="15.404040404040403%" id="d0e39">Field length</th>
<th align="left" valign="bottom" width="17.929292929292927%" id="d0e41">Example</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="29.797979797979796%" headers="d0e33 "><p>Hours:Minutes:Seconds</p>
</td>
<td align="left" valign="top" width="18.939393939393938%" headers="d0e35 "><p>*HMS</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e37 "><p>hh:mm:ss</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e39 "><p>8</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e41 "><p>14:00:00</p>
</td>
</tr>
<tr><td align="left" valign="top" width="29.797979797979796%" headers="d0e33 "><p>International<br />
Standards Organization</p>
</td>
<td align="left" valign="top" width="18.939393939393938%" headers="d0e35 "><p>*ISO</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e37 "><p>hh.mm.ss</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e39 "><p>8</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e41 "><p>14.00.00</p>
</td>
</tr>
<tr><td align="left" valign="top" width="29.797979797979796%" headers="d0e33 "><p>IBM USA Standard</p>
</td>
<td align="left" valign="top" width="18.939393939393938%" headers="d0e35 "><p>*USA</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e37 "><p>hh:mm AM or<br />
hh:mm PM</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e39 "><p>8</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e41 "><p>2:00 pm</p>
</td>
</tr>
<tr><td align="left" valign="top" width="29.797979797979796%" headers="d0e33 "><p>IBM European Standard</p>
</td>
<td align="left" valign="top" width="18.939393939393938%" headers="d0e35 "><p>*EUR</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e37 "><p>hh.mm.ss</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e39 "><p>8</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e41 "><p>14.00.00</p>
</td>
</tr>
<tr><td align="left" valign="top" width="29.797979797979796%" headers="d0e33 "><p>Japanese Industrial<br />
Standard Christian Era</p>
</td>
<td align="left" valign="top" width="18.939393939393938%" headers="d0e35 "><p>*JIS</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e37 "><p>hh:mm:ss</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e39 "><p>8</p>
</td>
<td align="left" valign="top" width="17.929292929292927%" headers="d0e41 "><p>14:00:00</p>
</td>
</tr>
</tbody>
</table>
</td></tr></table>
<p>If you do not specify the TIMFMT keyword, the default is *ISO.</p>
<p>If
you specify the time-format parameter value as *ISO, *USA, *EUR, or *JIS,
you cannot specify the TIMSEP keyword. These formats have fixed separators.</p>
<p>The
format of DFT, DFTVAL, and MAPVAL keyword values must match the format that
the TIMFMT keyword specifies. If the TIMFMT keyword is set to *ISO as default,
these values must have a format of *ISO.</p>
<p>The TIMFMT keyword overrides
the job attribute for a time field. It does not change the system default.</p>
<p>It
is the responsibility of the high-level language and the application to format
the time field according to the format specified for the TIMFMT keyword and
use the separators specified on the TIMSEP keyword. The system does not format
fields on output. The system validates the time field on input according to
the format the TIMFMT keyword specifies and the separator that the TIMSEP
keyword specifies.</p>
<p>Option indicators are not valid for this keyword,
although you can use option indicators to condition the field for which it
is specified.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the TIMFMT keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A
00020A R RECORD
00030A TIMFLD1 T B 5 2TIMFMT(*ISO)
00040A TIMFLD2 T B 5 22TIMFMT(*USA)
00050A TIMFLD3 T B 5 42TIMFMT(*HMS) TIMSEP(',')
A</pre>
<p>If you want to display 2 o'clock p.m., the following
values are displayed where RECORD1 appears.</p>
<pre>TIMFLD1 14.00.00
TIMFLD2 02:00 PM
TIMFLD3 14,00,00</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstkeyent.htm" title="You type the keyword entries that define display files in positions 45 through 80 (functions).">DDS keyword entries for display files (positions 45 through 80)</a></div>
</div>
</div>
</body>
</html>