CTIME.3
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:4k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. CTIME(3)                  Minix Programmer's Manual                   CTIME(3)
  2. NAME
  3.      ctime, localtime, gmtime, asctime, tzset -   convert  date  and  time  to
  4.      ASCII
  5. SYNOPSIS
  6.      #include <sys/types.h>
  7.      #include <time.h>
  8.      void tzset(void)
  9.      char *ctime(const time_t *clock)
  10.      char *asctime(const struct tm *tm)
  11.      struct tm *localtime(const time_t *clock)
  12.      struct tm *gmtime(const time_t *clock)
  13. DESCRIPTION
  14.      Tzset uses the value of the environment variable TZ to set  up  the  time
  15.      conversion information used by localtime.
  16.      If TZ does not appear in the environment, the TZDEFAULT file (as  defined
  17.      in  <tzfile.h>) is used by localtime.  If this file fails for any reason,
  18.      the GMT offset as provided by the kernel is used.  In this case,  DST  is
  19.      ignored,  resulting  in the time being incorrect by some amount if DST is
  20.      currently in effect.  If this fails for any reason, GMT is used.
  21.      If TZ appears in  the  environment  but  its  value  is  a  null  string,
  22.      Greenwich Mean Time is used; if TZ appears and begins with a slash, it is
  23.      used as the absolute pathname of the tzfile(5)-format file from which  to
  24.      read  the  time  conversion  information; if TZ appears and begins with a
  25.      character other than a slash, it's used as a  pathname  relative  to  the
  26.      system  time  conversion  information  directory, defined as TZDIR in the
  27.      include file tzfile.h.  If this file fails for any reason, the GMT offset
  28.      as provided by the kernel is used, as described above.  If this fails for
  29.      any reason, GMT is used.  See TZ(5) for a proper description  of  the  TZ
  30.      variable.
  31.      Ctime converts a time value, pointed to by clock,  such  as  returned  by
  32.      time(2)  into ASCII and returns a pointer to a 26-character string in the
  33.      following form.  All the fields have constant width.
  34.           Sun Sep 16 01:03:52 1973n
  35.      Localtime and gmtime return pointers to structures containing the broken-
  36.      down  time.   Localtime  corrects for the time zone and possible daylight
  37.      savings time; gmtime converts directly to GMT, which  is  the  time  UNIX
  38.      uses.  Asctime converts a broken-down time to ASCII and returns a pointer
  39.      to a 26-character string.
  40.      The structure declaration from the include file is:
  41. 4BSD                              April 2, 1987                              1
  42. CTIME(3)                  Minix Programmer's Manual                   CTIME(3)
  43.           struct tm {
  44.                 int tm_sec;    /* 0-59  seconds */
  45.                 int tm_min;    /* 0-59  minutes */
  46.                 int tm_hour;   /* 0-23  hour */
  47.                 int tm_mday;   /* 1-31  day of month */
  48.                 int tm_mon;    /* 0-11  month */
  49.                 int tm_year;   /* 0-    year - 1900 */
  50.                 int tm_wday;   /* 0-6   day of week (Sunday = 0) */
  51.                 int tm_yday;   /* 0-365 day of year */
  52.                 int tm_isdst;  /* flag: daylight savings time in effect */
  53.                 long tm_gmtoff; /* offset from GMT in seconds */
  54.                 char **tm_zone; /* abbreviation of timezone name */
  55.           };
  56.      Tm_isdst is non-zero if a time zone adjustment such as  Daylight  Savings
  57.      time is in effect.
  58.      Tm_gmtoff is the offset (in seconds) of the time  represented  from  GMT,
  59.      with positive values indicating East of Greenwich.
  60. FILES
  61.      /usr/lib/zoneinfo    time zone information directory
  62.      /etc/localtime       local time zone file
  63. SEE ALSO
  64.      time(2), getenv(3), tzfile(5), TZ(5), environ(7), zic(8).
  65. NOTE
  66.      The return values point to static data whose content  is  overwritten  by
  67.      each  call.  The tm_zone field of a returned struct tm points to a static
  68.      array of characters, which will also be overwritten at the next call (and
  69.      by calls to tzset).
  70. 4BSD                              April 2, 1987                              2