129 lines
3.9 KiB
HTML
129 lines
3.9 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>ILE CEE Date and Time Notation and Limits</title>
|
|
<!-- Begin Header Records ========================================= -->
|
|
<!-- 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. -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!-- ILE4A SCRIPT A converted by B2H R4.1 (346) (CMS) by NLJONES at -->
|
|
<!-- RCHVMX on 25 Feb 1999 at 10:53:17 -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<!-- End Header Records -->
|
|
<!-- Java sync-link -->
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
|
</script>
|
|
|
|
|
|
|
|
<h2>ILE CEE Date and Time Notation and Limits</h2>
|
|
|
|
<p>Calendars used by the date and time ILE CEE APIs have specific notation and
|
|
limits associated with them. Following is a description of the notation and the
|
|
limits.</p>
|
|
|
|
<h3>Notation</h3>
|
|
|
|
<p>Calendars based on eras use unique strings to identify these eras. An era is
|
|
defined by a major event in time from which date calculations take place. These
|
|
identification strings are called picture strings. The following picture
|
|
strings are supported:</p>
|
|
|
|
<dl>
|
|
<dt><strong>Japanese era</strong></dt>
|
|
|
|
<dd>Identified by one 6-character string
|
|
|
|
<pre>
|
|
<JJJJ>
|
|
</pre>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Republic of China (ROC) era</strong></dt>
|
|
|
|
<dd>Identified by one 6-character string
|
|
|
|
<pre>
|
|
<CCCC>
|
|
</pre>
|
|
|
|
or by one 10-character string
|
|
|
|
<pre>
|
|
<CCCCCCCC>
|
|
</pre>
|
|
</dd>
|
|
</dl>
|
|
|
|
<p>The era picture string begins with the less than character (<em><</em>)
|
|
and ends with the greater than character (<em>></em>). The characters within
|
|
these characters are either uppercase Js or uppercase Cs.</p>
|
|
|
|
<p><strong>Note:</strong> An era is defined by a major event in time from which
|
|
date calculations take place.</p>
|
|
|
|
<br>
|
|
<h3>Limits</h3>
|
|
|
|
<p>Date variables associated with certain calendars have certain limitations.
|
|
These limits are:</p>
|
|
|
|
<dl>
|
|
<dt><strong>starting Lilian date</strong></dt>
|
|
|
|
<dd>The beginning of the Lilian date range is set to 15 October 1582. This is
|
|
defined as Lilian day 1. Lilian day zero is defined as 14 October 1582, and is
|
|
used for calculation purposes in several of the APIs. Lilian second 1 is
|
|
defined as 00:00:01 on 14 October 1582, and is used for calculation purposes in
|
|
several of the APIs. Only Lilian dates greater than or equal to 1 are valid as
|
|
input or produced as output in the date and time APIs. This is the date of
|
|
adoption of the Gregorian calendar. Lilian dates preceding this date are
|
|
undefined.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>end Lilian date</strong></dt>
|
|
|
|
<dd>The end of the Lilian date range is set to 31 December 9999. Lilian dates
|
|
following this date are undefined.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>limit of current era</strong></dt>
|
|
|
|
<dd>The maximum future date that can be expressed in the era system must be
|
|
within the first 999 years of the current era. Future dates beyond year 999 of
|
|
the current era are not defined.<br>
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>number of eras</strong></dt>
|
|
|
|
<dd>The eras supported by ILE are shown within this section. No other past eras
|
|
are supported by ILE at the present time. Future eras will be added as
|
|
required.</dd>
|
|
</dl>
|
|
|
|
<hr>
|
|
<center>
|
|
<table cellpadding="2" cellspacing="2">
|
|
<tr align="center">
|
|
<td valign="middle" align="center">
|
|
<a href="#Top_Of_Page">Top</a> |
|
|
<a href="ile1a1.htm">ILE CEE APIs</a> |
|
|
<a href="aplist.htm">APIs by category</a></td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
</body>
|
|
</html>
|