release/man3/ctime.3

   1 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
   2 .\"
   3 .\" Permission is granted to make and distribute verbatim copies of this
   4 .\" manual provided the copyright notice and this permission notice are
   5 .\" preserved on all copies.
   6 .\"
   7 .\" Permission is granted to copy and distribute modified versions of this
   8 .\" manual under the conditions for verbatim copying, provided that the
   9 .\" entire resulting derived work is distributed under the terms of a
  10 .\" permission notice identical to this one.
  11 .\"
  12 .\" Since the Linux kernel and libraries are constantly changing, this
  13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  14 .\" responsibility for errors or omissions, or for damages resulting from
  15 .\" the use of the information contained herein.  The author(s) may not
  16 .\" have taken the same level of care in the production of this manual,
  17 .\" which is licensed free of charge, as they might when working
  18 .\" professionally.
  19 .\"
  20 .\" Formatted or processed versions of this manual, if unaccompanied by
  21 .\" the source, must acknowledge the copyright and authors of this work.
  22 .\"
  23 .\" References consulted:
  24 .\"     Linux libc source code
  25 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
  26 .\"     386BSD man pages
  27 .\" Modified Sat Jul 24 19:49:27 1993 by Rik Faith (faith@cs.unc.edu)
  28 .\" Modified Fri Apr 26 12:38:55 MET DST 1996 by Martin Schulze (joey@linux.de)
  29 .\" Modified 2001-11-13, aeb
  30 .\" Modified 2004-11-16, mtk
  31 .\"
  32 .\" Japanese Version Copyright (c) 1997 Hiroaki Nagoya
  33 .\"         all rights reserved.
  34 .\" Translated 1997-02-10, Hiroaki Nagoya <nagoya@is.titech.ac.jp>
  35 .\" Updated 1999-09-01, Kentaro Shirakata <argrath@ub32.org>
  36 .\" Updated 2001-10-15, Kentaro Shirakata <argrath@ub32.org>
  37 .\" Updated 2001-12-13, Kentaro Shirakata <argrath@ub32.org>
  38 .\" Updated 2002-01-03, Kentaro Shirakata <argrath@ub32.org>
  39 .\" Updated 2005-02-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  40 .\" Updated 2008-04-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.79
  41 .\" Updated 2008-08-08, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.05
  42 .\" Updated 2008-11-10, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.13
  43 .\"
  44 .\"WORD: Coordinated Univarsal Time  ¶¨ÄêÀ¤³¦»þ
  45 .\"WORD: broken-down time  Í×ÁÇÊÌ¤Î»þ¹ï
  46 .\"
  47 .TH CTIME 3 2010-02-25 "" "Linux Programmer's Manual"
  48 .SH Ì¾Á°
  49 asctime, ctime, gmtime, localtime, mktime, asctime_r, ctime_r, gmtime_r,
  50 localtime_r \- ÆüÉÕ¤È»þ¹ï¤òÍ×ÁÇÊÌ¤Î»þ¹ï¤ä ASCII ¤ËÊÑ´¹¤¹¤ë
  51 .SH ½ñ¼°
  52 .nf
  53 .B #include <time.h>
  54 .sp
  55 .BI "char *asctime(const struct tm *" tm );
  56 .br
  57 .BI "char *asctime_r(const struct tm *" tm ", char *" buf );
  58 .sp
  59 .BI "char *ctime(const time_t *" timep );
  60 .br
  61 .BI "char *ctime_r(const time_t *" timep ", char *" buf );
  62 .sp
  63 .BI "struct tm *gmtime(const time_t *" timep );
  64 .br
  65 .BI "struct tm *gmtime_r(const time_t *" timep ", struct tm *" result );
  66 .sp
  67 .BI "struct tm *localtime(const time_t *" timep );
  68 .br
  69 .BI "struct tm *localtime_r(const time_t *" timep ", struct tm *" result );
  70 .sp
  71 .BI "time_t mktime(struct tm *" tm );
  72 .fi
  73 .sp
  74 .in -4n
  75 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
  76 .RB ( feature_test_macros (7)
  77 »²¾È):
  78 .in
  79 .ad l
  80 .sp
  81 .BR asctime_r (),
  82 .BR ctime_r (),
  83 .BR gmtime_r (),
  84 .BR localtime_r ():
  85 .RS
  86 _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
  87 _SVID_SOURCE || _POSIX_SOURCE
  88 .RE
  89 .ad
  90 .SH ÀâÌÀ
  91 ´Ø¿ô
  92 .BR ctime (),
  93 .BR gmtime (),
  94 .BR localtime ()
  95 ¤Ï
  96 \fItime_t\fP ·¿¤Î¥«¥ì¥ó¥À¡¼»þ¹ï¤ò°ú¤¿ô¤Ë¤È¤ë¡£
  97 °ú¤¿ô¤¬ÀäÂÐÃÍ¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¾ì¹ç¤Ï¡¢»þ¹ïµª¸µ (Epoch;
  98 1970-01-01 00:00:00 +0000 (UTC)) ¤«¤é¤Î·Ð²áÉÃ¿ô¤È²ò¼á¤µ¤ì¤ë¡£
  99 .PP
 100 ´Ø¿ô
 101 .BR asctime ()
 102 ¤È
 103 .BR mktime ()
 104 ¤Ï
 105 Ç¯¡¦·î¡¦Æü¤Ê¤É¤ËÊ¬Î¥¤µ¤ì¤¿Í×ÁÇÊÌ¤Î»þ¹ï¤ò°ú¤¿ô¤È¤¹¤ë¡£
 106 .PP
 107 Í×ÁÇÊÌ¤Î»þ¹ï¤Ï \fI<time.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë
 108 \fItm\fP ¹½Â¤ÂÎ¤ËÊÝ»ý¤µ¤ì¤ë¡£
 109 .sp
 110 .in +4n
 111 .nf
 112 struct tm {
 113     int tm_sec;         /* ÉÃ */
 114     int tm_min;         /* ʬ */
 115     int tm_hour;        /* »þ´Ö */
 116     int tm_mday;        /* Æü */
 117     int tm_mon;         /* ·î */
 118     int tm_year;        /* ǯ */
 119     int tm_wday;        /* ÍËÆü */
 120     int tm_yday;        /* Ç¯ÆâÄÌ»»Æü */
 121     int tm_isdst;       /* ²Æ»þ´Ö */
 122 };
 123 .fi
 124 .in
 125 .PP
 126 \fItm\fP ¹½Â¤ÂÎ¤Î¥á¥ó¥Ð¡¼¤Ï°Ê²¼¤ÎÄÌ¤ê:
 127 .TP 10
 128 .I tm_sec
 129 ÉÃ¿ô¡¢¤Õ¤Ä¤¦¤Ï 0 ¤«¤é 59 ¤Þ¤Ç¤ÎÃÍ¡¢
 130 ¤·¤«¤·±¼ÉÃ¤Î¤¿¤á 60 ¤Þ¤Ç¤ÎÃÍ¤Ïµö¤µ¤ì¤ë¡£
 131 .TP
 132 .I tm_min
 133 Ê¬¿ô¡¢0 ¤«¤é 59 ¤Þ¤Ç¤ÎÃÍ¡£
 134 .TP
 135 .I tm_hour
 136 ¿¿ÌëÃæ¤«¤é¤ÎÄÌ»»»þ´Ö¡¢0 ¤«¤é 23 ¤Þ¤Ç¤ÎÃÍ¡£
 137 .TP
 138 .I tm_mday
 139 ·î¤Ï¤¸¤á¤«¤é¤ÎÆü¿ô¡¢1 ¤«¤é 31 ¤Þ¤Ç¤ÎÃÍ¡£
 140 .TP
 141 .I tm_mon
 142 1·î¤«¤é¤ÎÄÌ»»·î¿ô¡¢0 ¤«¤é 11 ¤Þ¤Ç¤ÎÃÍ¡£
 143 .TP
 144 .I tm_year
 145 1900 Ç¯¤«¤é¤ÎÄÌ»»Ç¯¿ô¡£
 146 .TP
 147 .I tm_wday
 148 ÆüÍËÆü¤«¤é¤ÎÄÌ»»Æü¿ô(ÍËÆü)¡£0 ¤«¤é 6 ¤Þ¤Ç¤ÎÃÍ¡£
 149 .TP
 150 .I tm_yday
 151 1 ·î 1 Æü¤«¤é¤ÎÄÌ»»Æü¿ô¡¢0 ¤«¤é 365 ¤Þ¤Ç¤ÎÃÍ¡£
 152 .TP
 153 .I tm_isdst
 154 ²Æ»þ´Ö¤¬Í¸ú¤«¤É¤¦¤«¤Î¥Õ¥é¥°¡£
 155 Àµ¤ÎÃÍ¤Ê¤é¤Ð²Æ»þ´Ö¤ÏÍ¸ú¤Ë¤Ê¤ê¡¢0 ¤Ê¤é¤ÐÌµ¸ú¡¢Éé¤ÎÃÍ¤Ê¤é¤Ð¤³¤Î¾ðÊó¤Ë¤Ï
 156 °ÕÌ£¤¬¤Ê¤¤¡£
 157 .PP
 158 .BI ctime( t )
 159 ´Ø¿ô¤Ï¡¢
 160 .BI asctime(localtime( t ))
 161 ¤ÈÅù²Á¤Ç¤¢¤ë¡£
 162 ¥«¥ì¥ó¥À¡¼»þ¹ï \fIt\fP ¤ò
 163 .sp
 164 .RS
 165 "Wed Jun 30 21:49:08 1993\\n"
 166 .RE
 167 .sp
 168 ¤È¤¤¤¦·Á¼°¤Î NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤ØÊÑ´¹¤¹¤ë¡£
 169 ÍËÆü¤ÎÎ¬¾Î¤Ï
 170 "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" ¤Ç¤¢¤ë¡£
 171 ·î¤ÎÎ¬¾Î¤Ï "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug",
 172 "Sep", "Oct", "Nov", "Dec" ¤Ç¤¢¤ë¡£
 173 ÊÖ¤êÃÍ¤Ï¡¢ÀÅÅª (static) ¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿Ê¸»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£
 174 ¤³¤ÎÊ¸»úÎó¤Ï¡¢ÆüÉÕ¡¦»þ¹ï´Ø¿ô¤Î¤¤¤º¤ì¤«¤¬¸Æ¤Ó½Ð¤µ¤ì¤ë¤È¾å½ñ¤¤µ¤ì¤ë¤³¤È¤¬¤¢¤ë¡£
 175 ¤Þ¤¿¤³¤Î´Ø¿ô¤ÏÂç°èÊÑ¿ô \fItzname\fP, \fItimezone\fP, \fIdaylight\fP
 176 ¤Ë¸½ºß¤Î¥¿¥¤¥à¥¾¡¼¥ó¤Î¾ðÊó¤òÀßÄê¤¹¤ë
 177 .RB ( tzset (3)
 178 »²¾È)¡£
 179 ¥ê¥¨¥ó¥È¥é¥ó¥ÈÈÇ¤Ç¤¢¤ë
 180 .BR ctime_r ()
 181 ¤âÆ±ÍÍ¤À¤¬¡¢
 182 Ê¸»úÎó¤Ï¥æ¡¼¥¶¡¼¤¬ÍÑ°Õ¤·¤¿¥Ð¥Ã¥Õ¥¡¤Ë³ÊÇ¼¤µ¤ì¤ë¡£¥Ð¥Ã¥Õ¥¡¤Î¥µ¥¤¥º¤Ï
 183 ¾¯¤Ê¤¯¤È¤â 26 ¥Ð¥¤¥È°Ê¾å¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 184 ¤³¤Î´Ø¿ô¤Ï \fItzname\fP, \fItimezone\fP, and \fIdaylight\fP
 185 ¤òÀßÄê¤¹¤ëÉ¬Í×¤Ï¤Ê¤¤¡£
 186 .PP
 187 ´Ø¿ô
 188 .BR gmtime ()
 189 ¤Ï¡¢¥«¥ì¥ó¥À¡¼»þ¹ï \fItimep\fP ¤ò
 190 ¶¨ÄêÀ¤³¦»þ (UTC) ¤Ç¤ÎÍ×ÁÇÊÌ¤Î»þ¹ï¤ØÊÑ´¹¤¹¤ë¡£
 191 Ç¯¤¬À°¿ô·¿¤Ë¼ý¤Þ¤é¤Ê¤¤¾ì¹ç¡¢NULL ¤òÊÖ¤¹¡£
 192 ÊÖ¤êÃÍ¤ÏÀÅÅª¤Ë³ÎÊÝ¤µ¤ì¤¿¹½Â¤ÂÎ¤ò»Ø¤·¤Æ¤ª¤ê¡¢¤³¤Î¸å¤Ç
 193 ÆüÉÕ¤ä»þ¹ï¤Ë´Ø¤¹¤ë´Ø¿ô¤Î¤¤¤º¤ì¤«¤¬¸Æ¤Ó½Ð¤µ¤ì¤ë¤È
 194 ¾å½ñ¤¤µ¤ì¤ë²ÄÇ½À¤¬¤¢¤ë¡£
 195 .BR gmtime_r ()
 196 ¤âÆ±ÍÍ¤À¤¬¡¢
 197 ¥Ç¡¼¥¿¤Ï¥æ¡¼¥¶¡¼¤¬ÍÑ°Õ¤·¤¿¹½Â¤ÂÎ¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 198 .PP
 199 ´Ø¿ô
 200 .BR localtime ()
 201 ¤Ï¡¢¥«¥ì¥ó¥À¡¼»þ¹ï \fItimep\fP ¤ò
 202 ¥æ¡¼¥¶¤¬»ØÄê¤·¤¿¥¿¥¤¥à¥¾¡¼¥ó¤Ç¤Î»þ¹ïÍ×ÁÇÊÌ¤ÎÉ½¸½¤ØÊÑ´¹¤¹¤ë¡£
 203 ¤³¤Î´Ø¿ô¤Ï
 204 .BR tzset (3)
 205 ¤ò¸Æ¤Ó½Ð¤·¤¿¤«¤Î¤è¤¦¤Ë¿¶Éñ¤¤¡¢
 206 Âç°èÊÑ¿ô \fItzname\fP ¤Ë¸½ºß¤Î¥¿¥¤¥à¥¾¡¼¥ó¤Î¾ðÊó¤òÀßÄê¤¹¤ë¡£
 207 ¤Þ¤¿¡¢\fItimezone\fP ¤Ë¶¨ÄêÀ¤³¦»þ (UTC) ¤È¥í¡¼¥«¥ëÉ¸½à»þ¤È¤Î
 208 »þº¹¤ÎÉÃ¿ô¤òÀßÄê¤·¡¢
 209 °ìÇ¯¤Î°ìÉô¤Ç²Æ»þ´Ö¤¬Å¬ÍÑ¤µ¤ì¤ë¾ì¹ç¤Ï \fIdaylight\fP ¤Ë 0 ¤¬ÀßÄê¤µ¤ì¤ë¡£
 210 ÊÖ¤êÃÍ¤ÏÀÅÅª¤Ë³ÎÊÝ¤µ¤ì¤¿¹½Â¤ÂÎ¤ò»Ø¤·¤Æ¤ª¤ê¡¢¤³¤Î¸å¤Ç
 211 ÆüÉÕ¤ä»þ¹ï¤Ë´Ø¤¹¤ë´Ø¿ô¤Î¤¤¤º¤ì¤«¤¬¸Æ¤Ó½Ð¤µ¤ì¤ë¤È
 212 ¾å½ñ¤¤µ¤ì¤ë²ÄÇ½À¤¬¤¢¤ë¡£
 213 .BR localtime_r ()
 214 ¤âÆ±ÍÍ¤À¤¬¡¢
 215 ¥Ç¡¼¥¿¤Ï¥æ¡¼¥¶¡¼¤¬ÍÑ°Õ¤·¤¿¹½Â¤ÂÎ¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 216 ¤³¤Î´Ø¿ô¤Ï \fItzname\fP, \fItimezone\fP, and \fIdaylight\fP
 217 ¤òÀßÄê¤¹¤ëÉ¬Í×¤Ï¤Ê¤¤¡£
 218 .PP
 219 ´Ø¿ô
 220 .BR asctime ()
 221 ¤Ï¡¢Í×ÁÇÊÌ¤Î»þ¹ï \fItm\fP ¤ò
 222 .BR ctime ()
 223 ¤ÈÆ±¤¸·Á¼°¤Î NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤ØÊÑ´¹¤¹¤ë¡£
 224 ÊÖ¤êÃÍ¤ÏÀÅÅª¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿Ê¸»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£¤³¤ÎÊ¸»úÎó¤Ï¡¢
 225 ÆüÉÕ¡¦»þ¹ï´Ø¿ô¤Î¤¤¤º¤ì¤«¤¬¸Æ¤Ó½Ð¤µ¤ì¤ë¤È¾å½ñ¤¤µ¤ì¤ë¤³¤È¤¬¤¢¤ë¡£
 226 ¥ê¥¨¥ó¥È¥é¥ó¥ÈÈÇ¤Ç¤¢¤ë
 227 .BR asctime_r ()
 228 ¤âÆ±ÍÍ¤À¤¬¡¢
 229 Ê¸»úÎó¤Ï¥æ¡¼¥¶¡¼¤¬ÍÑ°Õ¤·¤¿¥Ð¥Ã¥Õ¥¡¤Ë³ÊÇ¼¤µ¤ì¤ë¡£¥Ð¥Ã¥Õ¥¡¤Î¥µ¥¤¥º¤Ï
 230 ¾¯¤Ê¤¯¤È¤â 26 ¥Ð¥¤¥È°Ê¾å¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
 231 .PP
 232 ´Ø¿ô
 233 .BR mktime ()
 234 ¤Ï¡¢(¥í¡¼¥«¥ë¥¿¥¤¥à¤Çµ½Ò¤µ¤ì¤Æ¤¤¤ë) Í×ÁÇÊÌ¤Î»þ¹ï¤ò
 235 ¥«¥ì¥ó¥À¡¼»þ¹ï¤ØÊÑ´¹¤¹¤ë¡£¤³¤ÎºÝ¡¢¸Æ¤Ó½Ð¤·¸µ¤¬¥Õ¥£¡¼¥ë¥É
 236 .I tm_wday
 237 ¤È
 238 .I tm_yday
 239 ¤Ç»ØÄê¤·¤¿ÃÍ¤ÏÌµ»ë¤µ¤ì¤ë¡£
 240 .BR mktime ()
 241 ¤Ï¡¢¥Õ¥£¡¼¥ë¥É
 242 .I tm_isdst
 243 ¤Ç»ØÄê¤µ¤ì¤¿ÃÍ¤Ë¤è¤ê¡¢
 244 .I tm
 245 ¹½Â¤ÂÎ¤ÇÅÏ¤µ¤ì¤¿»þ¹ï¤Ç²Æ»þ´Ö (daylight saving time; DST) ¤¬Í¸ú¤Ë¤Ê¤Ã¤Æ
 246 ¤¤¤ë¤«¤òÃÎ¤ë¡£
 247 Àµ¤ÎÃÍ¤Ï²Æ»þ´Ö¤¬Í¸ú¤Ç¤¢¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
 248 Éé¤ÎÃÍ¤Ç¤¢¤ì¤Ð¡¢
 249 .BR mktime ()
 250 ¤Ï (¥¿¥¤¥à¥¾¡¼¥ó¾ðÊó¤È¥·¥¹¥Æ¥à¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¤ò»È¤Ã¤Æ)
 251 »ØÄê¤µ¤ì¤¿»þ¹ï¤Ç²Æ»þ´Ö¤¬Í¸ú¤«¤É¤¦¤«¤òÈ½ÃÇ¤¹¤ëÉ¬Í×¤¬¤¢¤ë¤³¤È¤ò°ÕÌ£¤¹¤ë¡£
 252
 253 .BR mktime ()
 254 ¤Ï
 255 .I tm
 256 ¹½Â¤ÂÎ¤Î³Æ¥Õ¥£¡¼¥ë¥É¤ò°Ê²¼¤Î¤è¤¦¤Ë½¤Àµ¤¹¤ë¡£
 257 .I tm_wday
 258 ¤È
 259 .I tm_yday
 260 ¤Ë¤ÏÂ¾¤Î¥Õ¥£¡¼¥ë¥É¤ÎÆâÍÆ¤«¤éµá¤á¤¿ÃÍ¤òÀßÄê¤¹¤ë¡£
 261 ¹½Â¤ÂÎ¤ÎÍ×ÁÇ¤¬Í¸ú¤ÊÈÏ°Ï¤Ë¤Ê¤¤¾ì¹ç¡¢Àµµ¬²½¤µ¤ì¤ë
 262 (Îã¤¨¤Ð¡¢10 ·î 40 Æü¤Ï 11 ·î 9 Æü¤ËÊÑ¹¹¤µ¤ì¤ë)¡£
 263 .I tm_isdst
 264 ¤Ë¤Ï (ºÇ½é¤ÎÃÍ¤Ë¤«¤«¤ï¤é¤º) Àµ¤ÎÃÍ¤« 0 ¤¬ÀßÄê¤µ¤ì¤ë¡£
 265 Àµ¤ÎÃÍ¤Ï»ØÄê¤µ¤ì¤¿»þ´Ö¤Ç²Æ»þ´Ö¤¬Í¸ú¤Ç¤¢¤ë¤³¤È¤ò¼¨¤·¡¢
 266 0 ¤ÏÌµ¸ú¤Ç¤¢¤ë¤³¤È¤ò¼¨¤¹¡£
 267 ´Ø¿ô
 268 .BR mktime ()
 269 ¤ò¸Æ¤Ó½Ð¤¹¤È¡¢
 270 Âç°èÊÑ¿ô \fItzname\fP ¤¬¸½ºß¤Î¥¿¥¤¥à¥¾¡¼¥ó¤ËÀßÄê¤µ¤ì¤ë¡£
 271
 272 Í×ÁÇÊÌ¤Î»þ¹ï¤ò¥«¥ì¥ó¥À¡¼»þ¹ï (µª¸µ (Epoch) ¤«¤é¤ÎÉÃ¿ô) ¤ÇÉ½¸½¤Ç¤¤Ê¤¤¾ì¹ç¡¢
 273 .BR mktime ()
 274 ¤Ï
 275 .I (time_t)\ (-1)
 276 ¤òÊÖ¤·¡¢Í×ÁÇÊÌ¤Î»þ¹ï¤Î¹½Â¤ÂÎ¥á¥ó¥Ð¡¼¤òÊÑ¹¹¤·¤Ê¤¤¡£
 277 .SH ÊÖ¤êÃÍ
 278 ³Æ´Ø¿ô¤Ï¤½¤ì¤¾¤ìÁ°½Ò¤·¤¿ÃÍ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¤Ï NULL
 279 .RB ( mktime ()
 280 ¤Ç¤Ï \-1) ¤òÊÖ¤¹¡£
 281 .SH ½àµò
 282 POSIX.1-2001.
 283 C89 ¤È C99 ¤Ç¤Ï
 284 .BR asctime (),
 285 .BR ctime (),
 286 .BR gmtime (),
 287 .BR localtime (),
 288 .BR mktime ()
 289 ¤¬µ¬Äê¤µ¤ì¤Æ¤¤¤ë¡£
 290 POSIX.1-2008 ¤Ï¡¢
 291 .BR asctime (),
 292 .BR asctime_r (),
 293 .BR ctime (),
 294 .BR ctime_r ()
 295 ¤òÇÑ»ßÍ½Äê¤È¤·¤Æ¤¤¤ë¡£
 296 Âå¤ï¤ê¤Ë¡¢
 297 .BR strftime (3)
 298 ¤Î»ÈÍÑ¤¬¿ä¾©¤µ¤ì¤Æ¤¤¤ë¡£
 299 .SH Ãí°Õ
 300 .BR asctime (),
 301 .BR ctime (),
 302 .BR gmtime (),
 303 .BR localtime ()
 304 ¤Î 4 ¤Ä¤Î´Ø¿ô¤ÏÀÅÅª¥Ç¡¼¥¿¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¤Î¤Ç¡¢¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ç¤Ï¤Ê¤¤¡£
 305 ¤³¤ì¤é¤Î´Ø¿ô¤Î¥¹¥ì¥Ã¥É¥»¡¼¥ÕÈÇ¤Ç¤¢¤ë
 306 .BR asctime_r (),
 307 .BR ctime_r (),
 308 .BR gmtime_r (),
 309 .BR localtime_r ()
 310 ¤Ï SUSv2 ¤Çµ¬Äê¤µ¤ì¤Æ¤ª¤ê¡¢
 311 libc 5.2.5 °Ê¹ß¤ÇÍøÍÑ¤Ç¤¤ë¡£
 312
 313 POSIX.1-2001 ¤Ç¤Ï¡¢¡Ö´Ø¿ô
 314 .BR asctime (),
 315 .BR ctime (),
 316 .BR gmtime (),
 317 .BR localtime ()
 318 ¤Ï¡¢Í×ÁÇÊÌ¤Î»þ¹ï¤Î¹½Â¤ÂÎ¤«
 319 .I char
 320 ·¿¤ÎÇÛÎó¤«¤Î¤É¤Á¤é¤«¤ÎÀÅÅª¥ª¥Ö¥¸¥§¥¯¥È¤òÊÖ¤¹¤â¤Î¤È¤¹¤ë¡£
 321 ¤³¤ì¤é¤Î´Ø¿ô¤Î¤¤¤º¤ì¤«¤ò¼Â¹Ô¤¹¤ë¤È¡¢Â¾¤Î´Ø¿ô¤Î¤É¤ì¤«¤¬¤³¤ì¤é¤Î
 322 ÀÅÅª¥ª¥Ö¥¸¥§¥¯¥È¤Î¤É¤Á¤é¤«¤Ë³ÊÇ¼¤·¤ÆÊÖ¤·¤¿¾ðÊó¤¬¾å½ñ¤¤µ¤ì¤ë¤«¤â
 323 ¤·¤ì¤Ê¤¤¡£¡×¤È¤Ê¤Ã¤Æ¤¤¤ë¡£
 324 ¤³¤Î¤³¤È¤Ï glibc ¤Î¼ÂÁõ¤Çµ¯¤³¤ê¤¦¤ë¡£
 325 .LP
 326 glibc ¤ò´Þ¤àÂ¿¤¯¤Î¼ÂÁõ¤Ç¤Ï¡¢
 327 .I tm_mday
 328 ¤Ë 0 ¤ò»ØÄê¤¹¤ë¤ÈÁ°·î¤ÎºÇ½ªÆü¤ò°ÕÌ£¤·¤Æ¤¤¤ë¤È²ò¼á¤µ¤ì¤ë¡£
 329 .LP
 330 glibc ¤Ç¤Ï¡¢
 331 .I <time.h>
 332 ¤¬¥¤¥ó¥¯¥ë¡¼¥É¤µ¤ì¤ëÁ°¤Ë
 333 .B _BSD_SOURCE
 334 ¤¬ÄêµÁ¤µ¤ì¤ë¤È¡¢
 335 \fIstruct tm\fP ¤Ë°Ê²¼¤Î¥Õ¥£¡¼¥ë¥É¤¬ÄÉ²Ã¤µ¤ì¤ë¡£
 336 .sp
 337 .RS
 338 .nf
 339 long tm_gmtoff;           /* Seconds east of UTC */
 340 const char *tm_zone;      /* Timezone abbreviation */
 341 .fi
 342 .RE
 343 .sp
 344 ¤³¤ì¤Ï BSD ³ÈÄ¥¤Ç¤¢¤ê¡¢4.3BSD-Reno ¤«¤é¸½¤ì¤¿¡£
 345
 346 POSIX.1-2004 ¤Ë¤è¤ë¤È¡¢
 347 .BR localtime ()
 348 ¤Ï¤¢¤¿¤«¤â
 349 .BR tzset (3)
 350 ¤¬¸Æ¤Ð¤ì¤¿¤«¤Î¤è¤¦¤Ë¿¶Éñ¤¦¤³¤È¤¬Í×µá¤µ¤ì¤Æ¤¤¤ë¤¬¡¢
 351 .BR localtime_r ()
 352 ¤Ë¤Ï¤³¤ÎÍ×·ï¤Ï¤Ê¤¤¡£
 353 .\" http://thread.gmane.org/gmane.comp.time.tz/2034/ ¤ò»²¾È¡£
 354 °Ü¿¢À¤¬É¬Í×¤Ê¥³¡¼¥É¤Ç¤Ï¡¢
 355 .BR localtime_r ()
 356 ¤ÎÁ°¤Ë
 357 .BR tzset (3)
 358 ¤ò¸Æ¤Ó½Ð¤·¤Æ¤ª¤¯¤Ù¤¤Ç¤¢¤ë¡£
 359 .SH ´ØÏ¢¹àÌÜ
 360 .BR date (1),
 361 .BR gettimeofday (2),
 362 .BR time (2),
 363 .BR utime (2),
 364 .BR clock (3),
 365 .BR difftime (3),
 366 .BR strftime (3),
 367 .BR strptime (3),
 368 .BR timegm (3),
 369 .BR tzset (3),
 370 .BR time (7)