2003-04-14
2003-04-14 15:04:41 by Martin Stjernholm <mast@lysator.liu.se>
-
0cc5eedd4115bf2f5e669e34cc2b84cb90a8116a
(17 lines)
(+9/-8)
[
Show
| Annotate
]
Branch: 7.4
Be more precise about the epoch time.
Rev: src/builtin_functions.c:1.458
2:
|| This file is part of Pike. For copyright information see COPYRIGHT.
|| Pike is distributed under GPL, LGPL and MPL. See the file COPYING
|| for more information.
- || $Id: builtin_functions.c,v 1.457 2003/03/28 14:23:23 marcus Exp $
+ || $Id: builtin_functions.c,v 1.458 2003/04/14 15:04:41 mast Exp $
*/
#include "global.h"
- RCSID("$Id: builtin_functions.c,v 1.457 2003/03/28 14:23:23 marcus Exp $");
+ RCSID("$Id: builtin_functions.c,v 1.458 2003/04/14 15:04:41 mast Exp $");
#include "interpret.h"
#include "svalue.h"
#include "pike_macros.h"
2061:
*! @decl int time(int(1..1) one)
*! @decl float time(int(2..) t)
*!
- *! This function returns the number of seconds since 1 Jan 1970.
+ *! This function returns the number of seconds since 00:00:00 UTC, Jan 1, 1970.
*!
*! The second syntax does not call the system call @tt{time()@} as often,
*! but is only updated in the backed (when Pike code isn't running).
4016: Inside #if defined(HAVE_GMTIME)
#ifdef HAVE_GMTIME
/*! @decl mapping(string:int) gmtime(int timestamp)
*!
- *! Convert seconds since 1970 into components.
+ *! Convert seconds since 00:00:00 UTC, Jan 1, 1970 into components.
*!
*! This function works like @[localtime()] but the result is
*! not adjusted for the local time zone.
4048: Inside #if defined(HAVE_LOCALTIME)
#ifdef HAVE_LOCALTIME
/*! @decl mapping(string:int) localtime(int timestamp)
*!
- *! Convert seconds since 1970 into components.
+ *! Convert seconds since 00:00:00 UTC, Jan 1, 1970 into components.
*!
*! @returns
*! This function returns a mapping with the following components:
4128: Inside #if defined(HAVE_MKTIME)
*! int isdst, int tz)
*!
*! This function converts information about date and time into an integer
- *! which contains the number of seconds since the beginning of 1970.
+ *! which contains the number of seconds since 00:00:00 UTC, Jan 1, 1970.
*!
*! You can either call this function with a mapping containing the
*! following elements:
4155: Inside #if defined(HAVE_MKTIME)
*! Or you can just send them all on one line as the second syntax suggests.
*!
*! @note
- *! On some operating systems (notably AIX), dates before Jan 1, 1970
- *! 00:00:00 UTC are not supported.
+ *! On some operating systems (notably AIX), dates before 00:00:00
+ *! UTC, Jan 1, 1970 are not supported.
*!
*! On most systems, the supported range of dates are Dec 13, 1901
*! 20:45:52 UTC through Jan 19, 2038 03:14:07 UTC (inclusive).