release/man3/strftime.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 .\"     GNU texinfo documentation on glibc date/time functions.
  28 .\" Modified Sat Jul 24 18:03:44 1993 by Rik Faith (faith@cs.unc.edu)
  29 .\" Applied fix by Wolfgang Franke, aeb, 961011
  30 .\" Corrected return value, aeb, 970307
  31 .\" Added Single UNIX Spec conversions and %z, aeb/esr, 990329.
  32 .\" 2005-11-22 mtk, added Glibc Notes covering optional 'flag' and
  33 .\"           'width' components of conversion specifications.
  34 .\"
  35 .\" Japanese Version Copyright (c) 2000 HANATAKA Shinya
  36 .\"         all rights reserved.
  37 .\" Translated 2000-10-10, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  38 .\" Updated 2002-01-09, Kentaro Shirakata <argrath@ub32.org>
  39 .\" Updated 2002-01-14, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  40 .\" Updated 2005-02-26, Akihiro MOTOKI
  41 .\" Updated 2005-04-17, Akihiro MOTOKI
  42 .\" Updated 2005-12-05, Akihiro MOTOKI, LDP v2.16
  43 .\" Updated 2010-04-18, Akihiro MOTOKI, LDP v3.24
  44 .\"
  45 .\"WORD:        conversion specifier            ÊÑ´¹»ØÄêÊ¸»ú
  46 .\"WORD:        conversion specification        ÊÑ´¹»ØÄê
  47 .\"WORD:        modifier                        ½¤¾þ»Ò
  48 .\"WORD:        broken-down time                Í×ÁÇÊÌ¤Î(»þ¹ï)
  49 .\"WORD:        Single UNIX Specification       Åý°ì UNIX µ¬³Ê
  50 .\"WORD:        ISO\ 8601 week-based            ISO\ 8601 ¤Î½µÃ±°ÌÉ½µ
  51 .\"
  52 .TH STRFTIME 3  2010-01-17 "GNU" "Linux Programmer's Manual"
  53 .SH Ì¾Á°
  54 strftime \- ÆüÉÕ¤ª¤è¤Ó»þ¹ï¤ÎÊ¸»úÎó¤Ø¤ÎÊÑ´¹
  55 .SH ½ñ¼°
  56 .nf
  57 .B #include <time.h>
  58 .sp
  59 .BI "size_t strftime(char *" s ", size_t " max ", const char *" format ,
  60 .BI "                const struct tm *" tm );
  61 .fi
  62 .SH ÀâÌÀ
  63 .BR strftime ()
  64 ´Ø¿ô ¤Ï¡¢Í×ÁÇÊÌ¤Î»þ¹ï \fItm\fP ¤ÎÆâÍÆ¤ò
  65 \fIformat\fP ¤Ç»ØÄê¤µ¤ì¤¿½ñ¼°»ØÄê¤Ë¤·¤¿¤¬¤Ã¤ÆÊÑ´¹¤·¡¢
  66 Ä¹¤µ \fImax\fP ¤ÎÊ¸»úÎó \fIs\fP ¤Ë½ñ¤¹þ¤à¡£
  67 .\" FIXME POSIX says: Local timezone information is used as though
  68 .\" strftime() called tzset().  But this doesn't appear to be the case
  69 .PP
  70 ½ñ¼°»ØÄê¤Ï NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Ç¤¢¤ê¡¢
  71 ¡ÖÊÑ´¹»ØÄê (conversion specification)¡×¤È¸Æ¤Ð¤ì¤ëÆÃÊÌ¤ÊÊ¸»úÎó¤ò
  72 ´Þ¤Þ¤ë¤³¤È¤¬¤Ç¤¤ë¡£
  73 ³Æ¡¹¤ÎÊÑ´¹»ØÄê¤Ï \(aq%\(aq Ê¸»ú¤Ç»Ï¤Þ¤ê¡¢
  74 ¡ÖÊÑ´¹»ØÄêÊ¸»ú (conversion specifier character)¡×¤È¸Æ¤Ð¤ì¤ë
  75 ²¿¤é¤«Â¾¤ÎÊ¸»ú¤Ç½ªÃ¼¤µ¤ì¤ë¡£¾åµ°Ê³°¤ÎÁ´¤Æ¤ÎÊ¸»úÎó¤Ï
  76 ¡ÖÄÌ¾ï¤ÎÊ¸»úÎó (ordinary character sequence)¡×¤È¤Ê¤ë¡£
  77 .PP
  78 (NULL ¥Ð¥¤¥È¤â´Þ¤à) ÄÌ¾ï¤ÎÊ¸»úÎóÆâ¤ÎÊ¸»ú¤Ï¡¢
  79 ¤½¤Î¤Þ¤Þ \fIformat\fP ¤«¤é \fIs\fP ¤Ë¥³¥Ô¡¼¤µ¤ì¤ë¡£
  80 °ìÊý¡¢ÊÑ´¹»ØÄê¤ÎÊ¸»ú¤Ï°Ê²¼¤Î¤è¤¦¤ËÃÖ´¹¤µ¤ì¤ë¡£
  81 .TP
  82 .B %a
  83 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤±¤ëÍËÆü¤Î¾ÊÎ¬Ì¾¡£
  84 .TP
  85 .B %A
  86 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤±¤ëÍËÆü¤Î´°Á´¤ÊÌ¾Á°¡£
  87 .TP
  88 .B %b
  89 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤±¤ë·î¤Î¾ÊÎ¬Ì¾¡£
  90 .TP
  91 .B %B
  92 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤±¤ë·î¤Î´°Á´¤ÊÌ¾Á°¡£
  93 .TP
  94 .B %c
  95 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤¤¤Æ°ìÈÌÅª¤ÊÆüÉÕ¡¦»þ¹ï¤ÎÉ½µ¡£
  96 .TP
  97 .B %C
  98 À¤µª (À¾ÎñÇ¯¤Î¾å 2 ·å)¡£ (SU)
  99 .TP
 100 .B %d
 101 ·îÆâÄÌ»»Æü (10 ¿Ê¿ôÉ½µ) (01-31)¡£
 102 .TP
 103 .B %D
 104 .B %m/%d/%y
 105 ¤ÈÅù²Á¡£(¤¦¤¨¤Ã¡¢¥¢¥á¥ê¥«ÀìÍÑ¤À¡£¥¢¥á¥ê¥«°Ê³°¤Î¹ñ¤Ç¤Ï
 106 .B %d/%m/%y
 107 ¤ÎÊý¤¬°ìÈÌÅª¤À¡£Ê¶¤é¤ï¤·¤¤¤Î¤Ç¡¢»ÈÍÑ¤¹¤Ù¤¤Ç¤Ï¤Ê¤¤¡£) (SU)
 108 .TP
 109 .B %e
 110 .B %d
 111 ¤ÈÆ±ÍÍ¤Ë·îÆâÄÌ»»Æü¤ò 10 ¿Ê¿ô¤ÇÉ½¸½¤¹¤ë¤¬¡¢
 112 1 ·å¤Î¾ì¹ç 10 ¤Î°Ì¤Ë¥¼¥í¤òÃÖ¤«¤º¥¹¥Ú¡¼¥¹¤òÃÖ¤¯¡£(SU)
 113 .TP
 114 .B %E
 115 ÊÌ·Á¼°¤ò»ÈÍÑ¤¹¤ëºÝ¤Î½¤¾þ»Ò¡£²¼µ»²¾È¡£ (SU)
 116 .TP
 117 .B %F
 118 .B %Y-%m-%d
 119 ¤ÈÅù²Á (ISO\ 8601 ·Á¼°¤ÎÆüÉÕ¥Õ¥©¡¼¥Þ¥Ã¥È)¡£ (C99)
 120 .TP
 121 .B %G
 122 ISO\ 8601 ½µÃ±°ÌÉ½µ¤ÎÇ¯ (week-based year; ¡ÖÃí°Õ¡×¤ÎÀá¤ò»²¾È)¡£
 123 À¤µª¤â 10 ¿Ê¿ô¤ÇÉ½¤¹¡£
 124 ISO ½µÈÖ¹æ
 125 .RB ( %V
 126 ¤ò»²¾È) ¤ËÂÐ±þ¤·¤¿ 4 ·å¤ÎÀ¾ÎñÇ¯¡£
 127 ¤³¤ì¤Ï´ðËÜÅª¤Ë¤Ï
 128 .B %Y
 129 ¤ÈÆ±¤¸·Á¼°¤À¤¬¡¢ISO ½µ¿ô¤¬Á°Ç¯¤äÍâÇ¯¤Ë¤Ê¤ë
 130 ¾ì¹ç¤Ë¤Ï¤½¤ÎÇ¯¤¬»ÈÍÑ¤µ¤ì¤ëÅÀ¤¬°Û¤Ê¤ë¡£(TZ)
 131 .TP
 132 .B %g
 133 .B %G
 134 ¤ÈÆ±ÍÍ¡£Ã¢¤·¡¢À¤µª¤ò´Þ¤Þ¤º²¼ 2 ·å¤Î¤ß¤òÉ½¼¨ (00-99)¡£ (TZ)
 135 .TP
 136 .B %h
 137 .B %b
 138 ¤ÈÅù²Á (SU)
 139 .TP
 140 .B %H
 141 24 »þ´ÖÉ½µ¤Ç¤Î»þ (hour)¡£ (00-23)
 142 .TP
 143 .B %I
 144 12 »þ´ÖÉ½µ¤Ç¤Î»þ (hour)¡£ (01-12)
 145 .TP
 146 .B %j
 147 Ç¯¤Î½é¤á¤«¤éÄÌ»»¤ÎÆü¿ô¡£ (001-366)
 148 .TP
 149 .B %k
 150 24 »þ´ÖÉ½µ¤Ç¤Î»þ (0-23)¡£
 151 1 ·å¤Î¾ì¹ç¤Ë¤ÏÁ°¤Ë¥¼¥í¤Ç¤Ê¤¯¥¹¥Ú¡¼¥¹¤¬ÃÖ¤«¤ì¤ë¡£
 152 .RB ( %H
 153 ¤â»²¾È) (TZ)
 154 .TP
 155 .B %l
 156 12 »þ´ÖÉ½µ¤Ç¤Î»þ (0-12)¡£
 157 1 ·å¤Î¾ì¹ç¤Ë¤ÏÁ°¤Ë¥¼¥í¤Ç¤Ê¤¯¥¹¥Ú¡¼¥¹¤¬ÃÖ¤«¤ì¤ë¡£
 158 .RB ( %I
 159 ¤â»²¾È) (TZ)
 160 .TP
 161 .B %m
 162 ·î (10 ¿Ê¿ôÉ½µ)¡£ (01-12)
 163 .TP
 164 .B %M
 165 Ê¬ (10 ¿Ê¿ôÉ½µ) (00-59)
 166 .TP
 167 .B %n
 168 ²þ¹Ô¡£ (SU)
 169 .TP
 170 .B %O
 171 ÊÌ·Á¼°¤ò»ÈÍÑ¤¹¤ëºÝ¤Î½¤¾þ»Ò¡£°Ê²¼¤ò»²¾È¡£(SU)
 172 .TP
 173 .B %p
 174 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤±¤ë¡Ö¸áÁ°¡×¡Ö¸á¸å¡×¤ËÁêÅö¤¹¤ëÊ¸»úÎó¡£
 175 ±Ñ¸ì¤Î¾ì¹ç¤Ë¤Ï "AM" ¤Þ¤¿¤Ï "PM" ¤È¤Ê¤ë¡£
 176 Àµ¸á¤Ï¡Ö¸á¸å¡×¡¢¿¿ÌëÃæ¤Ï¡Ö¸áÁ°¡×¤È¤·¤Æ°·¤ï¤ì¤ë¡£
 177 .TP
 178 .B %P
 179 .B %p
 180 ¤ÈÆ±ÍÍ¤Ç¤¢¤ë¤¬¾®Ê¸»ú¤¬»ÈÍÑ¤µ¤ì¤ë¡£
 181 ±Ñ¸ì¤Î¾ì¹ç¤Ë¤Ï "am" ¤ä "pm" ¤È¤Ê¤ë¡£(GNU)
 182 .TP
 183 .B %r
 184 ¸áÁ°¡¦¸á¸å·Á¼°¤Ç¤Î»þ¹ï¡£
 185 POSIX ¥í¥±¡¼¥ë¤Ç¤Ï
 186 .B "%I:%M:%S %p"
 187 ¤ÈÅù²Á¤Ç¤¢¤ë¡£(SU)
 188 .TP
 189 .B %R
 190 24 »þ´ÖÉ½µ¤Ç¤Î»þ¹ï¡¢ÉÃ¤ÏÉ½¼¨¤·¤Ê¤¤
 191 .RB ( %H:%M )¡£
 192 ÉÃ¤ò´Þ¤ó¤À¤â¤Î¤Ï°Ê²¼¤Î
 193 .B %T
 194 ¤ò»²¾È¤¹¤ë¤³¤È¡£(SU)
 195 .TP
 196 .B %s
 197 µª¸µ (Epoch; 1970-01-01 00:00:00 +0000 (UTC)) ¤«¤é¤ÎÉÃ¿ô¡£ (TZ)
 198 .TP
 199 .B %S
 200 ÉÃ (10 ¿Ê¿ôÉ½µ) (00-60)
 201 (»þ¡¹¤¢¤ë±¼ÉÃ¤ËÂÐ±þ¤¹¤ë¤¿¤á¡¢ÃÍ¤ÎÈÏ°Ï¤Ï 60 ¤Þ¤Ç¤È¤Ê¤Ã¤Æ¤¤¤ë)
 202 .TP
 203 .B %t
 204 ¥¿¥ÖÊ¸»ú (SU)
 205 .TP
 206 .B %T
 207 24 »þ´ÖÉ½µ¤Î»þ´Ö (\fB%H:%M:%S\fP) (SU)
 208 .TP
 209 .B %u
 210 ½µ¤Î²¿ÈÖÌÜ¤ÎÆü (10 ¿Ê¿ôÉ½µ) ¤«¡£·îÍËÆü¤ò 1 ¤È¤¹¤ë (1-7)¡£
 211 .B %w
 212 ¤â»²¾È¡£(SU)
 213 .TP
 214 .B %U
 215 Ç¯¤Î½é¤á¤«¤é¤ÎÄÌ»»¤Î½µÈÖ¹æ (10 ¿Ê¿ôÉ½µ) (00-53)¡£
 216 ¤½¤ÎÇ¯¤ÎºÇ½é¤ÎÆüÍËÆü¤ò¡¢Âè 1 ½µ¤Î»Ï¤Þ¤ê¤È¤·¤Æ·×»»¤¹¤ë¡£
 217 .B %V
 218 ¤È
 219 .B %W
 220 ¤â»²¾È¤¹¤ë¤³¤È¡£
 221 .TP
 222 .B %V
 223 ISO\ 8601 ·Á¼°¤Ç¤ÎÇ¯¤Î»Ï¤á¤«¤é¤Î½µÈÖ¹æ (¡ÖÃí°Õ¡×¤ÎÀá¤ò»²¾È)¡£
 224 10 ¿Ê¿ôÉ½µ¤Ç¡¢01 ¤«¤é 53 ¤ÎÃÍ¤È¤Ê¤ë¡£½µÈÖ¹æ¤Ï¡¢
 225 ¿·¤·¤¤Ç¯¤¬¾¯¤Ê¤¯¤È¤â 4 Æü°Ê¾å´Þ¤Þ¤ì¤ëºÇ½é¤Î½µ¤ò 1 ¤È¤·¤Æ·×»»¤¹¤ë¡£
 226 .B %U
 227 ¤È
 228 .B %W
 229 ¤â»²¾È¤Î¤³¤È¡£(SU)
 230 .TP
 231 .B %w
 232 ½µ¤Î²¿ÈÖÌÜ¤ÎÆü (10 ¿Ê¿ôÉ½µ) ¤«¡£ÆüÍËÆü¤ò 0 ¤È¤¹¤ë¡£(0-6)¡£
 233 .B %u
 234 ¤â»²¾È¡£(SU)
 235 .TP
 236 .B %W
 237 Ç¯¤Î½é¤á¤«¤é¤ÎÄÌ»»¤Î½µÈÖ¹æ (10 ¿Ê¿ôÉ½µ) (00-53)¡£
 238 ¤½¤ÎÇ¯¤ÎºÇ½é¤Î·îÍËÆü¤ò¡¢Âè 1 ½µ¤Î»Ï¤Þ¤ê¤È¤·¤Æ·×»»¤¹¤ë¡£
 239 .TP
 240 .B %x
 241 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ç°ìÈÌÅª¤ÊÆüÉÕÉ½µ¡£»þ¹ï¤Ï´Þ¤Þ¤Ê¤¤¡£
 242 .TP
 243 .B %X
 244 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ç°ìÈÌÅª¤Ê»þ¹ïÉ½µ¡£ÆüÉÕ¤Ï´Þ¤Þ¤Ê¤¤¡£
 245 .TP
 246 .B %y
 247 À¾Îñ¤Î²¼2·å (À¤µªÉôÊ¬¤ò´Þ¤Þ¤Ê¤¤Ç¯) (00-99)¡£
 248 .TP
 249 .B %Y
 250 À¤µªÉôÊ¬¤ò´Þ¤á¤¿ ( 4 ·å¤Î) À¾ÎñÇ¯¡£
 251 .TP
 252 .B %z
 253 .I +hhmm
 254 ¤ä
 255 .I -hhmm
 256 ¤Î·Á¼°¤Î¥¿¥¤¥à¥¾¡¼¥ó (UTC ¤Ø¤Î¥ª¥Õ¥»¥Ã¥È»þ´Ö)¡£(SU)
 257 .TP
 258 .B %Z
 259 ¥¿¥¤¥à¥¾¡¼¥ó¤Þ¤¿¤Ï¥¾¡¼¥óÌ¾¤Þ¤¿¤Ï¾ÊÎ¬Ì¾¡£
 260 .TP
 261 .B %+
 262 .\" Nov 05 -- Not in Linux/glibc, but is in some BSDs (according to
 263 .\" their man pages)
 264 .BR date (1)
 265 ·Á¼°¤Ç¤ÎÆü»þ¡£(TZ)
 266 (glibc2 ¤Ç¤Ï¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤)
 267 .TP
 268 .B %%
 269 \(aq%\(aq Ê¸»ú¡£
 270 .PP
 271 ¤¤¤¯¤Ä¤«¤ÎÊÑ´¹»ØÄê¤Ç¤Ï¡¢ÊÑ´¹»ØÄêÊ¸»ú¤ÎÁ°¤Ë
 272 .B E
 273 ¤ä
 274 .B O
 275 ¡Ö½¤¾þ»Ò¡×¤òÃÖ¤¯¤³¤È¤Ë¤è¤Ã¤ÆÊÌ½ñ¼°¤ò»ÈÍÑ¤¹¤ë¤è¤¦¤Ë»ØÄê¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
 276 ¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤¤¤ÆÊÌ½ñ¼°¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢
 277 ÄÌ¾ï¤ÎÊÑ´¹»ØÄê¤¬»ÈÍÑ¤µ¤ì¤¿¤«¤Î¤è¤¦¤ËÆ°ºî¤¹¤ë (SU)¡£
 278 Åý°ì UNIX µ¬³Ê (Single UNIX Specification) ¤Ç¤Ï
 279 .BR %Ec ,
 280 .BR %EC ,
 281 .BR %Ex ,
 282 .BR %EX ,
 283 .BR %Ey ,
 284 .BR %EY ,
 285 .BR %Od ,
 286 .BR %Oe ,
 287 .BR %OH ,
 288 .BR %OI ,
 289 .BR %Om ,
 290 .BR %OM ,
 291 .BR %OS ,
 292 .BR %Ou ,
 293 .BR %OU ,
 294 .BR %OV ,
 295 .BR %Ow ,
 296 .BR %OW ,
 297 .BR %Oy ,
 298 ¤Ë¤Ä¤¤¤Æµ½Ò¤¬¤¢¤ë¡£¤³¤³¤Ç
 299 .B O
 300 ½¤¾þ»Ò¤ÏÊÌ·Á¼°¤Î¿ôÃÍ (¥í¡¼¥Þ¿ô»ú¤È¤«) ¤ò»ØÄê¤¹¤ë¤¿¤á¤Ë»ÈÍÑ¤¹¤ë¡£
 301 .B E
 302 ½¤¾þ»Ò¤Ï¥í¥±¡¼¥ë°ÍÂ¸¤ÎÊÌÉ½¸½¤ò»ØÄê¤¹¤ë¤Î¤Ë»ÈÍÑ¤¹¤ë¡£
 303 (ÌõÃí:
 304 .B E
 305 ½¤¾þ»Ò¤ÏÆüËÜ¤Ç»ÈÍÑ¤µ¤ì¤Æ¤¤¤ë¡Ö¾¼ÏÂ¡×¡ÖÊ¿À®¡×
 306 ¤Ê¤É¤Î¸µ¹æ¤Ë¤è¤ëÇ¯É½µ¤ò»ØÄê¤¹¤ë¡£glibc 2.2 °Ê¹ß¤Ç¤Î¤ßÍ¸ú)
 307 .PP
 308 Í×ÁÇÊÌ¤Î»þ¹ï¹½Â¤ÂÎ \fItm\fP ¤Î¾ÜºÙ¤Ï \fI<time.h>\fP ¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
 309 .BR ctime (3)
 310 ¤â»²¾È¤¹¤ë¤³¤È¡£
 311 .SH ÊÖ¤êÃÍ
 312 .BR strftime ()
 313 ´Ø¿ô¤ÏÊ¸»úÎó \fIs\fP ¤Ë³ÊÇ¼¤µ¤ì¤¿Ê¸»ú¿ô¤òÊÖ¤¹¡£
 314 ¤³¤ÎÊ¸»ú¿ô¤Ë½ªÃ¼¤Î NULL ¥Ð¥¤¥È¤Ï´Þ¤Þ¤Ê¤¤¡£
 315 ½ªÃ¼¤Î NULL ¥Ð¥¤¥È¤ò³ÊÇ¼¤Ç¤¤ë¤À¤±¤ÎÂç¤¤µ¤ò»ý¤Ã¤¿Ê¸»úÎó¤òÅÏ¤¹¤³¤È¡£
 316 ¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï 0 ¤òÊÖ¤·¡¢Ê¸»úÎó¤ÎÆâÍÆ¤Ï½¤Àµ¤µ¤ì¤Ê¤¤¡£
 317 (libc 4.4.4 °Ê¹ß¤Ç¤³¤ÎµóÆ°¤¬Å¬ÍÑ¤µ¤ì¤Æ¤¤¤ë¡£
 318 libc 4.4.1 ¤Ê¤É¤ÎÈó¾ï¤Ë¸Å¤¤¥Ð¡¼¥¸¥ç¥ó¤Î libc ¤Ç¤Ï
 319 Ê¸»úÎó¤¬Ã»¤«²á¤®¤¿¾ì¹ç¤Ë¤Ï \fImax\fP ¤¬ÊÖ¤µ¤ì¤ë¡£)
 320 .LP
 321 ÊÖ¤êÃÍ 0 ¤ÏÉ¬¤º¤·¤â¥¨¥é¡¼¤ò°ÕÌ£¤·¤Æ¤¤¤ëÌõ¤Ç¤Ï¤Ê¤¤¤Î¤ÇÃí°Õ¤¹¤ë¤³¤È¡£
 322 Îã¤¨¤Ð¡¢Â¿¤¯¤Î¥í¥±¡¼¥ë¤Ç¤Ï
 323 .B %p
 324 ¤Ï¶õÊ¸»úÎó¤òÊÖ¤¹¡£
 325 .SH ´Ä¶ÊÑ¿ô
 326 ´Ä¶ÊÑ¿ô
 327 .B TZ
 328 ¤È
 329 .B LC_TIME
 330 ¤¬»ÈÍÑ¤µ¤ì¤ë¡£
 331 (ÌõÃí:
 332 .B LC_ALL
 333 ¤¬ÀßÄê¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï
 334 .B LC_TIME
 335 ¤è¤ê¤â¤½¤Á¤é¤¬Í¥Àè¤µ¤ì¤ë¡£
 336 .B LC_TIME
 337 ¤â
 338 .B LC_ALL
 339 ¤âÀßÄê¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ë¤Ï
 340 .B LANG
 341 ¤¬»ÈÍÑ¤µ¤ì¤ë¡£)
 342 .SH ½àµò
 343 SVr4, C89, C99.
 344 ¸Ä¡¹¤ÎÊÑ´¹¤¬¸·Ì©¤Ë¤É¤Îµ¬³Ê¤Ë´Þ¤Þ¤ì¤ë¤«¤Ï¡¢
 345 ANSI C (°õ¤Ê¤·)¡¢Åý°ì UNIX µ¬³Ê (SU°õ)¡¢Olson ¤Î timezone ¥Ñ¥Ã¥±¡¼¥¸ (TZ°õ)¡¢
 346 glibc ÆÈ¼« (GNU°õ) ¤Ç¼¨¤·¤Æ¤¤¤ë¡£glibc2 ¤Ç¤Ï
 347 .B %+
 348 ¤Ï¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¤¬¡¢
 349 ¤¤¤¯¤Ä¤«¤Î³ÈÄ¥¤¬¹Ô¤ï¤ì¤Æ¤¤¤ë¡£POSIX.1 ¤Ç¤Ï ANSI C ¤Î¤ß¤ò»²¾È¤·¤Æ¤¤¤ë¡£
 350 POSIX.2 ¤Î
 351 .BR date (1)
 352 ¤Î¤È¤³¤í¤Ëµ½Ò¤µ¤ì¤Æ¤¤¤ë´ö¤Ä¤«¤Î³ÈÄ¥¤Ï
 353 .BR strftime ()
 354 ¤Ë¤âÅ¬ÍÑ¤Ç¤¤ë¤À¤í¤¦¡£
 355 .B %F
 356 ÊÑ´¹¤Ï C99 ¤È POSIX.1-2001 ¤Ë¤¢¤ë¡£
 357
 358 SUSv2 ¤Ç¤Ï¡¢
 359 .B %S
 360 ¤Ï 00 ¤«¤é 61 ¤ÎÈÏ°Ï¤ò¤È¤ë¤Èµ¬Äê¤µ¤ì¤Æ¤¤¤ë¡£
 361 ¤³¤ì¤Ï¡¢1Ê¬´Ö¤Î¤¦¤Á±¼ÉÃ¤¬ 2¤ÄÆþ¤ë²ÄÇ½À¤¬ÍýÏÀÅª¤Ë¤Ï¤¢¤ë¤³¤È¤ò
 362 ¹ÍÎ¸¤·¤Æ¤Î¤â¤Î¤Ç¤¢¤ë (¼ÂºÝ¤Ë¤Ï¡¢¤³¤Î¤è¤¦¤Ê¾õ¶·¤Ï¤³¤ì¤Þ¤Ç°ìÅÙ¤â
 363 µ¯¤³¤Ã¤Æ¤¤¤Ê¤¤)¡£
 364 .SH Ãí°Õ
 365 .SS ISO\ 8601 ¤Î½µ¡¦ÍËÆüÉ½µ (Week Dates)
 366 .BR %G ,
 367 .BR %g ,
 368 .BR %V
 369 ¤Ï¡¢ISO\ 8601 É¸½à¤Ë¤è¤êÄêµÁ¤µ¤ì¤¿½µÃ±°ÌÉ½µ¤ÎÇ¯¤Ë¤è¤ê
 370 ·×»»¤µ¤ì¤ëÃÍ¤ò½ÐÎÏ¤¹¤ë¡£
 371 ISO\ 8601 É¸½à¤Î½µÃ±°ÌÉ½µ¤Ç¤Ï¡¢½µ¤Ï·îÍËÆü¤«¤é³«»Ï¤µ¤ì¡¢
 372 ½µÈÖ¹æ¤Ï¡¢Ç¯¤ÎºÇ½é¤Î½µ¤¬ 01 ¤È¤Ê¤ê¡¢ºÇ¸å¤Î½µ¤Ï 52 ¤« 53 ¤È¤Ê¤ë¡£
 373 ½µ 01 ¤Ï¡¢¿·¤·¤¤Ç¯¤¬ 4 Æü°Ê¾å´Þ¤Þ¤ì¤ëºÇ½é¤Î½µ¤Ç¤¢¤ë¡£
 374 ¸À¤¤´¹¤¨¤ë¤È¡¢½µ 01 ¤Ï¡¢¤½¤ÎÇ¯¤ÎÌÚÍËÆü¤ò´Þ¤àºÇ½é¤Î½µ¡¢
 375 ¤Ä¤Þ¤ê 1 ·î 4 Æü¤ò´Þ¤à½µ¤È¤¤¤¦¤³¤È¤Ç¤¢¤ë¡£
 376 ¿·¤·¤¤Ç¯¤Î¥«¥ì¥ó¥À¡¼¾å¤ÎºÇ½é¤Î½µ¤Ë¿·¤·¤¤Ç¯¤¬ 3 Æü°Ê²¼¤·¤«´Þ¤Þ¤ì¤Ê¤¤¾ì¹ç¡¢
 377 ISO\ 8601 ¤Î½µÃ±°ÌÉ½µ¤Ç¤Ï¡¢¤³¤ì¤é¤ÎÆü¤òÁ°¤ÎÇ¯¤Î½µ 53 ¤Î°ìÉô¤È¤ß¤Ê¤¹¡£
 378 Îã¤¨¤Ð¡¢2010 Ç¯ 1 ·î 1 Æü¤Ï¶âÍËÆü¤Ç¤¢¤ê¡¢
 379 ¤½¤Î½µ¤Ë¤Ï 2010 Ç¯¤ÎÆü¤¬ 3 Æü¤·¤«´Þ¤Þ¤ì¤Ê¤¤¡£
 380 ¤·¤¿¤¬¤Ã¤Æ¡¢ISO\ 8601 ¤Î½µÃ±°ÌÉ½µ¤Ç¤Ï¡¢¤³¤ì¤é¤ÎÆü¤Ï 2009 Ç¯ (\fB%G\fP)
 381 ¤Î½µ 53 (\fB%V\fP) ¤Î°ìÉô¤È¤Ê¤ë¡£
 382 ISO\ 8601 ¤Î 2010 Ç¯¤Î½µ 01 ¤Ï 2010 Ç¯ 1 ·î 4 Æü¤Î·îÍËÆü¤«¤é»Ï¤Þ¤ë¡£
 383 .SS glibc ¤Ç¤ÎÃí°Õ
 384 glibc ¤Ç¤ÏÊÑ´¹»ØÄê¤Ë¤¤¤¯¤Ä¤«³ÈÄ¥¤ò¹Ô¤Ã¤Æ¤¤¤ë
 385 (¤³¤ì¤é¤Î³ÈÄ¥¤Ï POSIX.1-2001 ¤Ë¤Ïµ¬Äê¤µ¤ì¤Æ¤¤¤Ê¤¤¤¬¡¢
 386 Â¾¤Î¤¤¤¯¤Ä¤«¤Î¥·¥¹¥Æ¥à¤ÇÆ±ÍÍ¤Îµ¡Ç½¤¬Äó¶¡¤µ¤ì¤Æ¤¤¤ë)¡£
 387 .\" HP-UX ¤È Tru64 ¤Ë¤âÆ±ÍÍ¤Îµ¡Ç½¤¬¤¢¤ë¡£
 388 \(aq%\(aq Ê¸»ú¤ÈÊÑ´¹»ØÄêÊ¸»ú¤Î´Ö¤Ë¡¢¥ª¥×¥·¥ç¥ó¤È¤·¤Æ
 389 .I flag
 390 ¤È¥Õ¥£¡¼¥ë¥É¤Î
 391 .I Éý
 392 ¤ò»ØÄê¤Ç¤¤ë (¤³¤ì¤é¤ò»ØÄê¤¹¤ë¾ì¹ç¤Ë¤Ï
 393 .B E
 394 ¤ä
 395 .B O
 396 ½¤¾þ»Ò¤ÎÁ°¤ËÃÖ¤¯)¡£
 397
 398 °Ê²¼¤Î¥Õ¥é¥°Ê¸»ú¤¬»ÈÍÑ¤Ç¤¤ë:
 399 .TP
 400 .B _
 401 (²¼Àþ)
 402 ¿ôÃÍ¤Î·ë²ÌÊ¸»úÎó¤Î¥Ñ¥Ç¥£¥ó¥° (·êËä¤á) ¤ò¥¹¥Ú¡¼¥¹ (¶õÇòÊ¸»ú) ¤Ç¹Ô¤¦¡£
 403 .TP
 404 .B \-
 405 (¥À¥Ã¥·¥å)
 406 ¿ôÃÍ¤Î·ë²ÌÊ¸»úÎó¤ËÂÐ¤¹¤ë¥Ñ¥Ç¥£¥ó¥°¤ò¹Ô¤ï¤Ê¤¤¡£
 407 .TP
 408 .B 0
 409 ÊÑ´¹»ØÄêÊ¸»ú¤¬¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï¥¹¥Ú¡¼¥¹¤Ç¥Ñ¥Ç¥£¥ó¥°¤ò¹Ô¤¦¾ì¹ç¤Ç¤â¡¢
 410 ¿ôÃÍ¤Î·ë²ÌÊ¸»úÎó¤Ø¤Î¥Ñ¥Ç¥£¥ó¥°¤ò 0 ¤Ç¹Ô¤¦¡£
 411 .TP
 412 .B ^
 413 ·ë²ÌÊ¸»úÎóÃæ¤Î¥¢¥ë¥Õ¥¡¥Ù¥Ã¥ÈÊ¸»ú¤òÂçÊ¸»ú¤ËÊÑ´¹¤¹¤ë¡£
 414 .TP
 415 .B #
 416 ·ë²ÌÊ¸»úÎó¤ÎÂçÊ¸»ú¡¦¾®Ê¸»ú¤òÆþ¤ìÂØ¤¨¤ë
 417 (¤³¤Î¥Õ¥é¥°¤ÏÆÃÄê¤ÎÊÑ´¹»ØÄêÊ¸»ú¤Ç¤·¤«µ¡Ç½¤·¤Ê¤¤¡£¤½¤ÎÃæ¤Ç¤â
 418 ËÜÅö¤ËÍÍÑ¤Ê¤Î¤Ï
 419 .B %Z
 420 ¤Î¾ì¹ç¤À¤±¤Ç¤¢¤ë)¡£
 421 .PP
 422 ¥ª¥×¥·¥ç¥ó¤Î10¿Ê¿ô¤ÎÉý»ØÄê»Ò¤Ï¥Õ¥é¥°¤Î¸å¤í¤ËÃÖ¤¯¤³¤È¤¬¤Ç¤¤ë
 423 (¥Õ¥é¥°¤Ï¤Ê¤¯¤Æ¤â¤è¤¤)¡£¥Õ¥£¡¼¥ë¥É¤ÎËÜÍè¤ÎÂç¤¤µ¤¬»ØÄê¤µ¤ì¤¿Éý¤è¤ê¤â
 424 ¾®¤µ¤¤¾ì¹ç¡¢·ë²ÌÊ¸»úÎó¤Îº¸Â¦¤Ï»ØÄê¤µ¤ì¤¿Éý¤Þ¤Ç¥Ñ¥Ç¥£¥ó¥°¤µ¤ì¤ë¡£
 425 .SH ¥Ð¥°
 426 .BR gcc (1)
 427 ¤Î¤¤¤¯¤Ä¤«¤Î¥Ð¡¼¥¸¥ç¥ó¤Ë¤Ï¤ª¤«¤·¤Ê¤È¤³¤í¤¬¤¢¤ê¡¢
 428 .B %c
 429 ¤Î»ÈÍÑË¡¤Ë¤Ä¤¤¤Æ°Ê²¼¤Î¤è¤¦¤Ê·Ù¹ð¤ò½Ð¤¹:
 430 .I "warning: `%c' yields only last 2 digits of year in some locales"
 431 .RI ( ·Ù¹ð: ¤¤¤¯¤Ä¤«¤Î¥í¥±¡¼¥ë¤Ç¤Ï `%c' ¤ÏÇ¯¤Î²¼2·å¤·¤«½ÐÎÏ¤·¤Ê¤¤ )¡£
 432 ¤â¤Á¤í¤ó¥×¥í¥°¥é¥Þ¤¬
 433 .B %c
 434 ¤ò»È¤¦¤Î¤Ï¤ªÁ¦¤á¤Ç¤¤ë¤³¤È¤Ç¤¢¤ë¡£
 435 .B %c
 436 ¤ò»È¤¦¤ÈÅ¬ÀÚ¤ÊÆüÉÕ¤È»þ¹ï¤ÎÉ½µ¤òÆÀ¤ë¤³¤È¤¬¤Ç¤¤ë¤«¤é¤Ç¤¢¤ë¡£
 437 .BR gcc (1)
 438 ¤Î¤³¤ÎÌäÂê¤ò²óÈò¤·¤è¤¦¤È¤¹¤ë¤È¡¢²¿¤«¤¹¤Ã¤¤ê¤·¤Ê¤¤µ¤Ê¬¤Ë¤Ê¤ë¤À¤í¤¦¡£
 439 Èæ³ÓÅª¤¤ì¤¤¤Ê²ò·èÊýË¡¤Ï°Ê²¼¤Î¤è¤¦¤ÊÃæ´Ö´Ø¿ô¤òÄÉ²Ã¤¹¤ë¤³¤È¤Ç¤¢¤ë¡£
 440 .in +4n
 441 .nf
 442
 443 size_t
 444 my_strftime(char *s, size_t max, const char *fmt,
 445             const struct tm *tm)
 446 {
 447     return strftime(s, max, fmt, tm);
 448 }
 449 .fi
 450 .in
 451 .RE
 452
 453 ¸½ºß¤Ç¤Ï¡¢
 454 .BR gcc (1)
 455 ¤Ï¤³¤Î·Ù¹ð¤òÍÞ¤¨¤ë¤¿¤á¤Î \fI\-Wno\-format\-y2k\fP ¥ª¥×¥·¥ç¥ó¤ò
 456 Äó¶¡¤·¤Æ¤ª¤ê¡¢¾åµ¤Î²óÈòºö¤Ï¤â¤Ï¤äÉ¬Í×¤Ê¤¤¡£
 457 .SH Îã
 458 .B "RFC\ 2822 ½àµò¤ÎÆüÉÕ·Á¼°"
 459 (%a ¤È %b ¤Ï±Ñ¸ì¥í¥±¡¼¥ë)
 460 .PP
 461 .in +2n
 462 "%a,\ %d\ %b\ %Y\ %T\ %z"
 463 .PP
 464 .B "RFC\ 822 ½àµò¤ÎÆüÉÕ·Á¼°"
 465 (%a ¤È %b ¤Ï±Ñ¸ì¥í¥±¡¼¥ë)
 466 .PP
 467 .in +2n
 468 "%a,\ %d\ %b\ %y\ %T\ %z"
 469 .SS ¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à
 470 °Ê²¼¤Î¥×¥í¥°¥é¥à¤ò»È¤¦¤È
 471 .BR strftime ()
 472 ¤Î¼Â¸³¤¬¤Ç¤¤ë¡£
 473 .PP
 474 °Ê²¼¤Ë¡¢
 475 .BR strftime ()
 476 ¤Î glibc ¼ÂÁõ¤¬À¸À®¤¹¤ë·ë²Ì¤ÎÎã¤ò¤¤¤¯¤Ä¤«¼¨¤¹:
 477 .nf
 478
 479 .RB "$" " ./a.out \(aq%m\(aq"
 480 Result string is "11"
 481 .RB "$" " ./a.out \(aq%5m\(aq"
 482 Result string is "00011"
 483 .RB "$" " ./a.out \(aq%_5m\(aq"
 484 Result string is "   11"
 485 .fi
 486 .in
 487 .PP
 488 ¥×¥í¥°¥é¥à¤Î¥½¡¼¥¹¤Ï°Ê²¼¤ÎÄÌ¤ê:
 489 .nf
 490
 491 #include <time.h>
 492 #include <stdio.h>
 493 #include <stdlib.h>
 494
 495 int
 496 main(int argc, char *argv[])
 497 {
 498     char outstr[200];
 499 .PP
 500 °Ê²¼¤Ë¡¢
 501 .BR strftime ()
 502 ¤Î glibc ¼ÂÁõ¤¬À¸À®¤¹¤ë·ë²Ì¤ÎÎã¤ò¤¤¤¯¤Ä¤«¼¨¤¹:
 503 .nf
 504
 505 $ ./a.out "%m"
 506 Result string is "11"
 507 $ ./a.out "%5m"
 508 Result string is "00011"
 509 $ ./a.out "%_5m"
 510 Result string is "   11"
 511 .fi
 512     time_t t;
 513     struct tm *tmp;
 514
 515     t = time(NULL);
 516     tmp = localtime(&t);
 517     if (tmp == NULL) {
 518         perror("localtime");
 519         exit(EXIT_FAILURE);
 520     }
 521
 522     if (strftime(outstr, sizeof(outstr), argv[1], tmp) == 0) {
 523         fprintf(stderr, "strftime returned 0");
 524         exit(EXIT_FAILURE);
 525     }
 526
 527     printf("Result string is \\"%s\\"\\n", outstr);
 528     exit(EXIT_SUCCESS);
 529 }
 530 .fi
 531 .SH ´ØÏ¢¹àÌÜ
 532 .BR date (1),
 533 .BR time (2),
 534 .BR ctime (3),
 535 .BR setlocale (3),
 536 .BR sprintf (3),
 537 .BR strptime (3)