From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Kevin Ryde Newsgroups: gmane.lisp.guile.devel Subject: doc mktime Date: Fri, 04 Feb 2005 10:15:56 +1100 Message-ID: <871xbx2q1f.fsf@zip.com.au> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1107472712 23088 80.91.229.6 (3 Feb 2005 23:18:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 3 Feb 2005 23:18:32 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Fri Feb 04 00:18:01 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CwqEb-0003tM-00 for ; Fri, 04 Feb 2005 00:18:01 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1CwqRz-0001Ny-IE for guile-devel@m.gmane.org; Thu, 03 Feb 2005 18:31:52 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1CwqQV-0000ja-Cz for guile-devel@gnu.org; Thu, 03 Feb 2005 18:30:19 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1CwqQT-0000iK-Ej for guile-devel@gnu.org; Thu, 03 Feb 2005 18:30:18 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1CwqQS-0000iG-1X for guile-devel@gnu.org; Thu, 03 Feb 2005 18:30:16 -0500 Original-Received: from [61.8.0.85] (helo=mailout2.pacific.net.au) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CwqCk-0000E8-Dd for guile-devel@gnu.org; Thu, 03 Feb 2005 18:16:06 -0500 Original-Received: from mailproxy1.pacific.net.au (mailproxy1.pacific.net.au [61.8.0.86]) by mailout2.pacific.net.au (8.12.3/8.12.3/Debian-7.1) with ESMTP id j13NG2Hn006472 for ; Fri, 4 Feb 2005 10:16:02 +1100 Original-Received: from localhost (ppp27BE.dyn.pacific.net.au [61.8.39.190]) by mailproxy1.pacific.net.au (8.12.3/8.12.3/Debian-7.1) with ESMTP id j13NFxVT029664 for ; Fri, 4 Feb 2005 10:16:00 +1100 Original-Received: from gg by localhost with local (Exim 3.36 #1 (Debian)) id 1CwqCb-0000en-00; Fri, 04 Feb 2005 10:15:57 +1100 Original-To: guile-devel@gnu.org Mail-Copies-To: never User-Agent: Gnus/5.110003 (No Gnus v0.3) Emacs/21.3 (gnu/linux) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.lisp.guile.devel:4761 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:4761 * posix.texi (Time): In mktime, clarify fields of sbd-time used, and the handling of tm:isdst. -- Scheme Procedure: mktime sbd-time [zone] -- C Function: scm_mktime (sbd_time, zone) For a broken down time object SBD-TIME, return a pair the `car' of which is an integer time like `current-time', and the `cdr' of which is a new broken down time with normalized fields. ZONE is a timezone string, or the default is the `TZ' environment variable or the system default (*note Specifying the Time Zone with `TZ': (libc)TZ Variable.). SBD-TIME is taken to be in that ZONE. The following fields of SBD-TIME are used: `tm:year', `tm:mon', `tm:mday', `tm:hour', `tm:min', `tm:sec', `tm:isdst'. The values can be outside their usual ranges. For example `tm:hour' normally goes up to 23, but a value say 33 would mean 9 the following day. `tm:isdst' in SBD-TIME says whether the time given is with daylight savings or not. This is ignored if ZONE doesn't have any daylight savings adjustment amount. The broken down time in the return normalizes the values of SBD-TIME by bringing them into their usual ranges, and using the actual daylight savings rule for that time in ZONE (which may differ from what SBD-TIME had). The easiest way to think of this is that SBD-TIME plus ZONE converts to the integer UTC time, then a `localtime' is applied to get the normal presentation of that time, in ZONE. _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://lists.gnu.org/mailman/listinfo/guile-devel