ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahy_5.4.0.1/rzahyutctime.htm

80 lines
4.4 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 xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" 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. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<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))' />
<title>Directory Server (LDAP) - Generalized and UTC time</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="rzahyutctime"></a>
<h3 id="rzahyutctime">Generalized and UTC time</h3>
<p>There are different notations used to designate date and time-related information.
For example, the fourth day of February in the year 1999 can be written as:</p>
<pre class="xmp">2/4/99
4/2/99
99/2/4
4.2.1999
04-FEB-1999</pre><p class="indatacontent">as well as many other notations.</p>
<p>Directory Server standardizes the timestamp representation by requiring
the LDAP servers to support two syntaxes:</p>
<ul>
<li>The Generalized Time syntax, which takes the form:
<pre class="xmp">YYYYMMDDHHMMSS[.|,fraction][(+|-HHMM)|Z]</pre>There are 4 digits for the year, 2 digits each for the month, day, hour,
minute, and second, and an optional fraction of a second. Without any further
additions, a date and time is assumed to be in a local time zone. To indicate
that a time is measured in Coordinated Universal Time, append a capital
letter Z to a time or a local time differential. For example:
<pre class="xmp"> "19991106210627.3"</pre>which in local time is 6 minutes, 27.3 seconds after
9 p.m. on 6 November 1999.
<pre class="xmp">"19991106210627.3Z"</pre>which
is the coordinated universal time.
<pre class="xmp">"19991106210627.3-0500"</pre>which is local time as in the first example, with a 5 hour difference
in relation to the coordinated universal time.
<p>If you designate an optional
fraction of a second, a period or a comma is required. For local time differential,
a '+' or a '-' must precede the hour-minute value</p></li>
<li>The Universal time syntax, which takes the form:
<pre class="xmp">YYMMDDHHMM[SS][(+ | -)HHMM)|Z]</pre>There are 2 digits each for the year, month, day, hour, minute, and
optional second fields. As in GeneralizedTime, an optional time differential
can be specified. For example, if local time is a.m. on 2 January 1999 and
the coordinated universal time is 12 noon on 2 January 1999, the value of
UTCTime is either:
<pre class="xmp">"9901021200Z"
or
"9901020700-0500"</pre>If the local time is a.m. on 2 January 2001 and the
coordinated universal time is 12 noon on 2 January 2001, the value of UTCTime
is either:
<pre class="xmp">"0101021200Z"
or
"0101020700-0500"</pre>UTCTime allows only 2 digits for the year value, therefore
the usage is not recommended.</li></ul>
<p>The supported matching rules are generalizedTimeMatch for equality and
generalizedTimeOrderingMatch for inequality. Substring search is not allowed.
For example, the following filters are valid:</p>
<pre class="xmp"> generalized-timestamp-attribute=199910061030
utc-timestamp-attribute>=991006
generalized-timestamp-attribute=*</pre><p class="indatacontent">The following filters are
not valid: </p>
<pre class="xmp">generalized-timestamp-attribute=1999*
utc-timestamp-attribute>=*1010</pre>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>