release/man3/getdate.3

   1 .\" Copyright 2001 walter harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   3 .\"     <mtk.manpages@gmail.com>
   4 .\"
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one.
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\"
  25 .\" Modified, 2001-12-26, aeb
  26 .\" 2008-09-07, mtk, Various rewrites; added an example program.
  27 .\"
  28 .\" Japanese Version Copyright (c) 2002 NAKANO Takeo
  29 .\" and Copyright (c) 2008, Akihiro MOTOKI all rights reserved.
  30 .\"
  31 .\" Translated 2002-01-12, NAKANO Takeo <nakano@apm.seikei.ac.jp>
  32 .\" Updated 2008-09-20, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.09
  33 .\"
  34 .\"WORD:        broken-down time        Í×ÁÇÊÌ¤Î»þ¹ï
  35 .\"
  36 .TH GETDATE 3 2008-09-07 "" "Linux Programmer's Manual"
  37 .SH Ì¾Á°
  38 getdate, getdate_r \- ÆüÉÕ¤È»þ¹ï¤ÎÊ¸»úÎó¤òÍ×ÁÇÊÌ¤Î»þ¹ï¤ËÊÑ´¹¤¹¤ë
  39 .SH ½ñ¼°
  40 .B "#define _XOPEN_SOURCE 500"
  41 .br
  42 .B "#include <time.h>"
  43 .sp
  44 .BI "struct tm *getdate(const char *" string );
  45 .sp
  46 .B "extern int getdate_err;"
  47 .sp
  48 .B "#define _GNU_SOURCE"
  49 .br
  50 .B "#include <time.h>"
  51 .sp
  52 .BI "int getdate_r(const char *" string ", struct tm *" res );
  53 .SH ÀâÌÀ
  54 .BR getdate ()
  55 ´Ø¿ô¤Ï¡¢
  56 .I string
  57 ¤¬»Ø¤¹¥Ð¥Ã¥Õ¥¡¤Ë³ÊÇ¼¤µ¤ì¤¿Ê¸»úÎóÉ½¸½¤ÎÆüÉÕ¤È»þ¹ï¤ò¡¢
  58 Í×ÁÇÊÌ¤Î»þ¹ï (broken-down time) ¤ËÊÑ´¹¤¹¤ë¡£
  59 Í×ÁÇÊÌ¤Î»þ¹ï¤Ï
  60 .I tm
  61 ¹½Â¤ÂÎ¤Ë³ÊÇ¼¤µ¤ì¡¢¤³¤Î¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤¬´Ø¿ô¤Î·ë²Ì¤È¤·¤ÆÊÖ¤µ¤ì¤ë¡£
  62 ¤³¤Î
  63 .I tm
  64 ¹½Â¤ÂÎ¤ÏÀÅÅª¤Ê¥á¥â¥êÎÎ°è¤Ë¤¢¤ê¡¢
  65 .BR getdate ()
  66 ¤Î¤½¤ì°Ê¹ß¤Î¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤¤µ¤ì¤ë¤«¤â¤µ¤ì¤Ê¤¤¡£
  67 .PP
  68 .RI ( format
  69 °ú¤¿ô¤Ç¥Õ¥©¡¼¥Þ¥Ã¥È¤ò»ØÄê¤¹¤ë)
  70 .BR strptime (3)
  71 ¤È¤Ï°ã¤¤¡¢
  72 .BR getdate ()
  73 ¤Ï´Ä¶ÊÑ¿ô
  74 .B DATEMSK
  75 ¤Ç»ØÄê¤µ¤ì¤¿¥Õ¥ë¥Ñ¥¹Ì¾¤Î¥Õ¥¡¥¤¥ë¤Ë½ñ¤¤¤Æ¤¢¤ë¥Õ¥©¡¼¥Þ¥Ã¥È¤òÍÑ¤¤¤ë¡£
  76 .PP
  77 ¥Þ¥Ã¥Á¤ÎºÝ¤Ë¤ÏÂçÊ¸»ú¾®Ê¸»ú¤ò¶èÊÌ¤·¤Ê¤¤¡£
  78 ¥Ñ¥¿¡¼¥óÃæ¤Ç¤âÊÑ´¹¤µ¤ì¤ëÊ¸»úÎóÃæ¤Ç¤â¡¢Í¾Ê¬¤Ê¶õÇòÊ¸»ú¤ÏÌµ»ë¤µ¤ì¤ë¡£
  79 .PP
  80 ¥Ñ¥¿¡¼¥ó¤Ë»ØÄê¤Ç¤¤ëÊÑ´¹»ØÄê¤Ï¡¢
  81 .BR strptime (3)
  82 ¤Î¤â¤Î¤ÈÆ±¤¸¤Ç¤¢¤ë¡£
  83 POSIX.1-2001 ¤Ç¤Ï°ì¤Ä¤ÎÊÑ´¹»ØÄê¤¬ÄÉ²Ã¤Çµ¬Äê¤µ¤ì¤Æ¤¤¤ë¡£
  84 .TP
  85 .B %Z
  86 ¥¿¥¤¥à¥¾¡¼¥ó¤ÎÌ¾Á°¡£
  87 glibc ¤Ç¤Ï¼ÂÁõ¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
  88 .LP
  89 .B %Z
  90 ¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¡¢Í×ÁÇÊÌ¤Î»þ¹ï¤ò³ÊÇ¼¤¹¤ë¹½Â¤ÂÎ¤Ï¡¢
  91 »ØÄê¤µ¤ì¤¿¥¿¥¤¥à¥¾¡¼¥ó¤Ë¤ª¤±¤ë¸½ºß»þ¹ï¤ËÂÐ±þ¤¹¤ëÃÍ¤Ç½é´ü²½¤µ¤ì¤ë¡£
  92 »ØÄê¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢¤³¤Î¹½Â¤ÂÎ¤Ï¸½ºß¤Î¥í¡¼¥«¥ë¥¿¥¤¥à¤ËÂÐ±þ¤¹¤ë
  93 Í×ÁÇÊÌ¤Î»þ¹ï¤Ç½é´ü²½¤µ¤ì¤ë
  94 .RB ( localtime (3)
  95 ¤ò¸Æ¤Ó½Ð¤·¤¿¾ì¹ç¤ÈÆ±¤¸)¡£
  96 .LP
  97 ÍËÆü¤À¤±¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¡¢
  98 º£Æü¤Þ¤¿¤Ïº£Æü°Ê¹ß¤Ç¡¢
  99 ¤½¤ÎÍËÆü¤Ë¹çÃ×¤¹¤ëºÇ½é¤ÎÆü¤¬ºÎÍÑ¤µ¤ì¤ë¡£
 100 .LP
 101 (Ç¯¤Ê¤·¤Ç) ·î¤À¤±¤¬»ØÄê¤µ¤ì¤¿¾ì¹ç¡¢
 102 º£·î¤Þ¤¿¤Ïº£·î°Ê¹ß¤Ç¡¢
 103 ¤½¤Î·î¤Ë¹çÃ×¤¹¤ëºÇ½é¤Î·î¤¬ºÎÍÑ¤µ¤ì¤ë¡£
 104 .LP
 105 »þ¡¦Ê¬¡¦ÉÃ¤¬¤¤¤º¤ì¤â»ØÄê¤µ¤ì¤Ê¤«¤Ã¤¿¾ì¹ç¡¢
 106 ¸½ºß¤Î»þ¡¦Ê¬¡¦ÉÃ¤¬ºÎÍÑ¤µ¤ì¤ë¡£
 107 .LP
 108 ÆüÉÕ¤Î»ØÄê¤¬¤Ê¤«¤Ã¤¿¤¬¡¢»þ´Ö (hour) ¤À¤±»ØÄê¤µ¤ì¤¿¾ì¹ç¤Ï¡¢
 109 ¸½ºß¤Î»þ´Ö¤Þ¤¿¤Ï¤½¤ì°Ê¹ß¤Ç¡¢¤½¤Î»ØÄê¤Ë¹çÃ×¤¹¤ëºÇ½é¤Î»þ´Ö¤¬ºÎÍÑ¤µ¤ì¤ë¡£
 110
 111 .BR getdate_r ()
 112 ¤Ï GNU ³ÈÄ¥¤Ç
 113 .BR getdate ()
 114 ¤Î¥ê¥¨¥ó¥È¥é¥ó¥ÈÈÇ¤òÄó¶¡¤·¤Æ¤¤¤ë¡£
 115 .BR getdate_r ()
 116 ¤Ç¤Ï¡¢¥¨¥é¡¼¤òÊó¹ð¤¹¤ë¤Î¤Ë¥°¥í¡¼¥Ð¥ëÊÑ¿ô¤ò»ÈÍÑ¤·¤¿¤ê¡¢
 117 Í×ÁÇÊÌ¤Î»þ¹ï¤òÊÖ¤¹¤Î¤ËÀÅÅª¤Ê¥Ð¥Ã¥Õ¥¡¤ò»ÈÍÑ¤·¤¿¤ê¤»¤º¡¢
 118 ¥¨¥é¡¼¤ò´Ø¿ô¤ÎÊÖ¤êÃÍ·ÐÍ³¤ÇÊó¹ð¤·¡¢Í×ÁÇÊÌ¤Î»þ¹ï¤ò
 119 °ú¤¿ô
 120 .I res
 121 ¤¬»Ø¤·¼¨¤¹¸Æ¤Ó½Ð¤·Â¦¤Ç³ä¤êÅö¤Æ¤¿¥Ð¥Ã¥Õ¥¡¤Ë³ÊÇ¼¤·¤ÆÊÖ¤¹¡£
 122 .SH ÊÖ¤êÃÍ
 123 À®¸ù¤¹¤ë¤È¡¢
 124 .BR getdate ()
 125 ¤Ï
 126 .I struct tm
 127 ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
 128 ¼ºÇÔ¤¹¤ë¤È NULL ¤òÊÖ¤·¡¢¥°¥í¡¼¥Ð¥ëÊÑ¿ô
 129 .I getdate_err
 130 ¤Ë°Ê²¼¤Ë¼¨¤¹¥¨¥é¡¼ÈÖ¹æ¤Î¤¤¤º¤ì¤«°ì¤Ä¤òÀßÄê¤¹¤ë¡£
 131 .I errno
 132 ¤ÎÊÑ¹¹¤Ë¤Ä¤¤¤Æ¤Ïµ¬Äê¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
 133
 134 À®¸ù¤¹¤ë¤È¡¢
 135 .BR getdate_r ()
 136 ¤Ï 0 ¤òÊÖ¤¹¡£
 137 ¼ºÇÔ¤¹¤ë¤È¡¢°Ê²¼¤Ë¼¨¤¹¥¨¥é¡¼ÈÖ¹æ¤Î¤¤¤º¤ì¤«°ì¤Ä¤òÊÖ¤¹¡£
 138 .SH ¥¨¥é¡¼
 139 °Ê²¼¤Î¥¨¥é¡¼¤¬¡¢
 140 .RB ( getdate ()
 141 ¤Ç¤Ï)
 142 .I getdate_err
 143 ·ÐÍ³¤ÇÊÖ¤µ¤ì¡¢
 144 .RB ( getdate_r ()
 145 ¤Ç¤Ï) ´Ø¿ô¤ÎÊÖ¤êÃÍ¤È¤·¤ÆÊÖ¤µ¤ì¤ë¡£
 146 .TP 4n
 147 .B 1
 148 ´Ä¶ÊÑ¿ô
 149 .B DATEMASK
 150 ¤¬Ì¤ÄêµÁ¡¢¤Þ¤¿¤Ï¤½¤ÎÃÍ¤¬¶õÊ¸»úÎó¤Ç¤¢¤ë¡£
 151 .TP
 152 .B 2
 153 .B DATEMSK
 154 ¤Ç»ØÄê¤µ¤ì¤¿¥Æ¥ó¥×¥ì¡¼¥È¥Õ¥¡¥¤¥ë¤òÆÉ¤ß¹þ¤ßÍÑ¤Ë¥ª¡¼¥×¥ó¤Ç¤¤Ê¤¤¡£
 155 .TP
 156 .B 3
 157 ¥Õ¥¡¥¤¥ë¤Î¥¹¥Æ¡¼¥¿¥¹¾ðÊó¤¬¼èÆÀ¤Ç¤¤Ê¤¤¡£
 158 .\" stat()
 159 .TP
 160 .B 4
 161 ¥Æ¥ó¥×¥ì¡¼¥È¥Õ¥¡¥¤¥ë¤¬ÄÌ¾ï¤Î¥Õ¥¡¥¤¥ë¤Ç¤Ê¤¤¡£
 162 .TP
 163 .B 5
 164 ¥Æ¥ó¥×¥ì¡¼¥È¥Õ¥¡¥¤¥ë¤ÎÆÉ¤ß¹þ¤ßÃæ¤Ë¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¡£
 165 .TP
 166 .B 6
 167 ¥á¥â¥ê¤Î³ä¤êÅö¤Æ¤Ë¼ºÇÔ¤·¤¿ (¥á¥â¥ê¤¬Â¤ê¤Ê¤¤)¡£
 168 .\" ¥¨¥é¡¼ 6 ¤Ï glibc ¤Ç¤ÏÈ¯À¸¤·¤Ê¤¤¤è¤¦¤Ë¸«¤¨¤ë¡£
 169 .TP
 170 .B 7
 171 ÆþÎÏ¤Ë¥Þ¥Ã¥Á¤·¤¿¥Õ¥¡¥¤¥ë¤Ë¡¢¹Ô¤¬´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤¡£
 172 .TP
 173 .B 8
 174 ÆþÎÏ»ØÄê¤¬Àµ¤·¤¯¤Ê¤¤¡£
 175 .SH ´Ä¶ÊÑ¿ô
 176 .TP
 177 .B DATEMSK
 178 ½ñ¼°¥Ñ¥¿¡¼¥ó¤ò´Þ¤à¥Õ¥¡¥¤¥ë¡£
 179 .TP
 180 .BR TZ ", " LC_TIME
 181 .BR strptime (3)
 182 ¤¬ÍÑ¤¤¤ëÊÑ¿ô¡£
 183 .SH ½àµò
 184 POSIX.1-2001.
 185 .SH Ãí°Õ
 186 POSIX.1-2001 »ÅÍÍ¤Ç¤Ï¡¢
 187 .BR strptime (3)
 188 ¤Ë¤Ä¤¤¤Æ¤Ï
 189 .B %E
 190 ¤ä
 191 .B %O
 192 ¤È¤¤¤Ã¤¿½¤Àµ»Ò¤òÍÑ¤¤¤¿ÊÑ´¹»ØÄê¤òµ¬Äê¤·¤Æ¤¤¤ë¤¬¡¢
 193 .BR getdate ()
 194 ¤Ë¤Ä¤¤¤Æ¤Ï¤³¤Î¤è¤¦¤Ê½¤¾þ»Ò¤Îµ¬Äê¤Ï¤Ê¤¤¡£
 195 glibc ¤Ç¤Ï¡¢
 196 .BR getdate ()
 197 ¤Ï
 198 .BR strptime (3)
 199 ¤òÍÑ¤¤¤Æ¼ÂÁõ¤µ¤ì¤Æ¤ª¤ê¡¢
 200 Î¾¼Ô¤Ç¤ÏÁ´¤¯Æ±¤¸ÊÑ´¹¤¬Î¾¼Ô¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£
 201 .SH Îã
 202 °Ê²¼¤Î¥×¥í¥°¥é¥à¤Ï¡¢¥³¥Þ¥ó¥É¥é¥¤¥ó°ú¤¿ô¤Î¤½¤ì¤¾¤ì¤Ë¤Ä¤¤¤Æ
 203 .BR getdate ()
 204 ¤ò¸Æ¤Ó½Ð¤·¡¢¤½¤ì¤¾¤ì¤Ë¤Ä¤¤¤ÆÊÖ¤µ¤ì¤¿
 205 .I tm
 206 ¹½Â¤ÂÎ¤Î¥Õ¥£¡¼¥ë¥ÉÃÍ¤òÉ½¼¨¤¹¤ë¡£
 207 ¼¡¤Î¥·¥§¥ë¡¦¥»¥Ã¥·¥ç¥ó¤Ï¡¢¥×¥í¥°¥é¥à¤ÎÆ°ºîÎã¤Ç¤¢¤ë¡£
 208
 209 .in +4n
 210 .nf
 211 .RB "$" " TFILE=$PWD/tfile"
 212 .RB "$" " echo \(aq%A\(aq > $TFILE " "      # Full weekday name"
 213 .RB "$" " echo \(aq%T\(aq >> $TFILE" "      # ISO date (YYYY-MM-DD)"
 214 .RB "$" " echo \(aq%F\(aq >> $TFILE" "      # Time (HH:MM:SS)"
 215 .RB "$" " date"
 216 .RB "$" " export DATEMSK=$TFILE"
 217 .RB "$" " ./a.out Tuesday \(aq2009-12-28\(aq \(aq12:22:33\(aq"
 218 Sun Sep  7 06:03:36 CEST 2008
 219 Call 1 ("Tuesday") succeeded:
 220     tm_sec   = 36
 221     tm_min   = 3
 222     tm_hour  = 6
 223     tm_mday  = 9
 224     tm_mon   = 8
 225     tm_year  = 108
 226     tm_wday  = 2
 227     tm_yday  = 252
 228     tm_isdst = 1
 229 Call 2 ("2009-12-28") succeeded:
 230     tm_sec   = 36
 231     tm_min   = 3
 232     tm_hour  = 6
 233     tm_mday  = 28
 234     tm_mon   = 11
 235     tm_year  = 109
 236     tm_wday  = 1
 237     tm_yday  = 361
 238     tm_isdst = 0
 239 Call 3 ("12:22:33") succeeded:
 240     tm_sec   = 33
 241     tm_min   = 22
 242     tm_hour  = 12
 243     tm_mday  = 7
 244     tm_mon   = 8
 245     tm_year  = 108
 246     tm_wday  = 0
 247     tm_yday  = 250
 248     tm_isdst = 1
 249 .fi
 250 .in
 251 .SS ¥×¥í¥°¥é¥à¤Î¥½¡¼¥¹
 252 \&
 253 .nf
 254 #define _GNU_SOURCE 500
 255 #include <time.h>
 256 #include <stdio.h>
 257 #include <stdlib.h>
 258
 259 int
 260 main(int argc, char *argv[])
 261 {
 262     struct tm *tmp;
 263     int j;
 264
 265     for (j = 1; j < argc; j++) {
 266         tmp = getdate(argv[j]);
 267
 268         if (tmp == NULL) {
 269             printf("Call %d failed; getdate_err = %d\\n",
 270                    j, getdate_err);
 271             continue;
 272         }
 273
 274         printf("Call %d (\\"%s\\") succeeded:\\n", j, argv[j]);
 275         printf("    tm_sec   = %d\\n", tmp\->tm_sec);
 276         printf("    tm_min   = %d\\n", tmp\->tm_min);
 277         printf("    tm_hour  = %d\\n", tmp\->tm_hour);
 278         printf("    tm_mday  = %d\\n", tmp\->tm_mday);
 279         printf("    tm_mon   = %d\\n", tmp\->tm_mon);
 280         printf("    tm_year  = %d\\n", tmp\->tm_year);
 281         printf("    tm_wday  = %d\\n", tmp\->tm_wday);
 282         printf("    tm_yday  = %d\\n", tmp\->tm_yday);
 283         printf("    tm_isdst = %d\\n", tmp\->tm_isdst);
 284     }
 285
 286     exit(EXIT_SUCCESS);
 287 }
 288 .fi
 289 .SH ´ØÏ¢¹àÌÜ
 290 .BR time (2),
 291 .BR localtime (3),
 292 .BR setlocale (3),
 293 .BR strftime (3),
 294 .BR strptime (3),
 295 .BR feature_test_macros (7)