53 lines
4.7 KiB
HTML
53 lines
4.7 KiB
HTML
<!-- Common Lisp HyperSpec (TM), version 7.0 generated by Kent M. Pitman on Mon, 11-Apr-2005 2:31am EDT -->
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>CLHS: Section 25.1.4.1</TITLE>
|
|
<LINK HREF="../Data/clhs.css" REL="stylesheet" TYPE="text/css" />
|
|
<META HTTP-EQUIV="Author" CONTENT="Kent M. Pitman">
|
|
<META HTTP-EQUIV="Organization" CONTENT="LispWorks Ltd.">
|
|
<LINK REL=TOP HREF="../Front/index.htm">
|
|
<LINK REL=COPYRIGHT HREF="../Front/Help.htm#Legal">
|
|
<LINK REL=DISCLAIMER HREF="../Front/Help.htm#Disclaimer">
|
|
<LINK REL=PREV HREF="25_ad.htm">
|
|
<LINK REL=UP HREF="25_ad.htm">
|
|
<LINK REL=NEXT HREF="25_adb.htm">
|
|
</HEAD>
|
|
<BODY>
|
|
<H1><A REV=MADE HREF="http://www.lispworks.com/"><IMG WIDTH=80 HEIGHT=65 ALT="[LISPWORKS]" SRC="../Graphics/LWSmall.gif" ALIGN=Bottom></A><A REL=TOP HREF="../Front/index.htm"><IMG WIDTH=237 HEIGHT=65 ALT="[Common Lisp HyperSpec (TM)]" SRC="../Graphics/CLHS_Sm.gif" ALIGN=Bottom></A> <A REL=PREV HREF="25_ad.htm"><IMG WIDTH=40 HEIGHT=40 ALT="[Previous]" SRC="../Graphics/Prev.gif" ALIGN=Bottom></A><A REL=UP HREF="25_ad.htm"><IMG WIDTH=40 HEIGHT=40 ALT="[Up]" SRC="../Graphics/Up.gif" ALIGN=Bottom></A><A REL=NEXT HREF="25_adb.htm"><IMG WIDTH=40 HEIGHT=40 ALT="[Next]" SRC="../Graphics/Next.gif" ALIGN=Bottom></A></H1>
|
|
|
|
<HR>
|
|
|
|
<H2>
|
|
25.1.4.1 Decoded Time</H2> <P>
|
|
A <A REL=DEFINITION HREF="26_glo_d.htm#decoded_time"><I>decoded time</I></A> is an ordered series of nine values that, taken together, represent a point in calendar time (ignoring <A REL=DEFINITION HREF="26_glo_l.htm#leap_seconds"><I>leap seconds</I></A>): <P>
|
|
<P><DL><DT><B>Second</B> <P><DD>
|
|
An <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> between 0 and 59, inclusive. <P>
|
|
<DT><B>Minute</B> <P><DD>
|
|
An <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> between 0 and 59, inclusive. <P>
|
|
<DT><B>Hour</B> <P><DD>
|
|
An <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> between 0 and 23, inclusive. <P>
|
|
<DT><B>Date</B> <P><DD>
|
|
An <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> between 1 and 31, inclusive (the upper limit actually depends on the month and year, of course). <P>
|
|
<DT><B>Month</B> <P><DD>
|
|
An <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> between 1 and 12, inclusive; 1 means January, 2 means February, and so on; 12 means December. <P>
|
|
<DT><B>Year</B> <P><DD>
|
|
An <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> indicating the year A.D. However, if this <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> is between 0 and 99, the ``obvious'' year is used; more precisely, that year is assumed that is equal to the <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> modulo 100 and within fifty years of the current year (inclusive backwards and exclusive forwards). Thus, in the year 1978, year 28 is 1928 but year 27 is 2027. (Functions that return time in this format always return a full year number.) <P>
|
|
<DT><B>Day of week</B> <P><DD>
|
|
An <A REL=DEFINITION HREF="26_glo_i.htm#integer"><I>integer</I></A> between 0 and 6, inclusive; 0 means Monday, 1 means Tuesday, and so on; 6 means Sunday. <P>
|
|
<DT><B>Daylight saving time flag</B> <P><DD>
|
|
A <A REL=DEFINITION HREF="26_glo_g.htm#generalized_boolean"><I>generalized boolean</I></A> that, if <A REL=DEFINITION HREF="26_glo_t.htm#true"><I>true</I></A>, indicates that daylight saving time is in effect. <P>
|
|
<DT><B>Time zone</B> <P><DD>
|
|
A <A REL=DEFINITION HREF="26_glo_t.htm#time_zone"><I>time zone</I></A>. <P>
|
|
<P></DL><P>
|
|
The next figure shows <A REL=DEFINITION HREF="26_glo_d.htm#defined_name"><I>defined names</I></A> relating to <A REL=DEFINITION HREF="26_glo_d.htm#decoded_time"><I>decoded time</I></A>. <P>
|
|
<PRE>
|
|
<A REL=DEFINITION HREF="f_dec_un.htm#decode-universal-time">decode-universal-time</A> <A REL=DEFINITION HREF="f_get_un.htm#get-decoded-time">get-decoded-time</A>
|
|
</PRE>
|
|
<P><B>Figure 25-5. Defined names involving time in Decoded Time.</B> <P>
|
|
<HR>
|
|
|
|
<A REL=NAVIGATOR HREF="../Front/StartPts.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Starting Points]" SRC="../Graphics/StartPts.gif" ALIGN=Bottom></A><A REL=TOC HREF="../Front/Contents.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Contents]" SRC="../Graphics/Contents.gif" ALIGN=Bottom></A><A REL=INDEX HREF="../Front/X_Master.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Index]" SRC="../Graphics/Index.gif" ALIGN=Bottom></A><A REL=INDEX HREF="../Front/X_Symbol.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Symbols]" SRC="../Graphics/Symbols.gif" ALIGN=Bottom></A><A REL=GLOSSARY HREF="../Body/26_a.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Glossary]" SRC="../Graphics/Glossary.gif" ALIGN=Bottom></A><A HREF="../Front/X3J13Iss.htm"><IMG WIDTH=80 HEIGHT=40 ALT="[Issues]" SRC="../Graphics/Issues.gif" ALIGN=Bottom></A><BR>
|
|
|
|
<A REL=COPYRIGHT HREF="../Front/Help.htm#Legal"><I>Copyright 1996-2005, LispWorks Ltd. All rights reserved.</I></A><P>
|
|
</BODY>
|
|
</HTML>
|