.\" Copyright 1993 Mitchum DSouza <m.dsouza@mrc-apu.cam.ac.uk>
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified, jmv@lucifer.dorms.spbu.ru, 1999-11-08
.\" Modified, aeb, 2000-04-07
.\" Updated from glibc docs, C. Scott Ananian, 2001-08-25
.\" Modified, aeb, 2001-08-31
.\" Modified, wharms 2001-11-12, remark on white space and example
.\"
.\" Japanese Version Copyright (c) 1998 SHOJI Yasushi all rights reserved.
.\" Translated Fri Jun 26 1998 by SHOJI Yasushi <yashi@yashi.com>
.\" Updated & Modefied Sun Mar 7 1999 by Shouichi Saito
.\" Updated Tue Oct 10 22:29:13 JST 2000
.\" 	by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
.\" Updated Tue Apr  3 20:49:00 JST 2001
.\"     by Yuichi SATO <ysato@h4.dion.ne.jp>
.\" Updated Thu Oct 11 10:05:36 JST 2001 by Yuichi SATO
.\" Updated Fri Dec 14 16:34:23 JST 2001 by Yuichi SATO
.\" Updated Sat Jan  5 22:17:34 JST 2002 by Yuichi SATO
.\" Updated Wed Jan 14 23:21:57 JST 2002 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" 
.\"WORD:	modifier	
.\"WORD:	broken-down time	̤λ
.\" 
.TH STRPTIME 3 2001-11-12 "GNU" "Linux Programmer's Manual"
.SH ̾
strptime \- ʸǤ蘆Ƥ֤ tm ¤Τλ֤Ѵ
.SH 
.BR "#define _XOPEN_SOURCE" " /* glibc2 Ǥϡ줬ɬס */"
.br
.B #include <time.h>
.sp
.BI "char *strptime(const char *" s ", const char *" format ,
.BI "struct tm *" tm );
.SH 
.B strptime()
ؿ
.B strftime()
εմؿǤꡢݥ
.I s
ؤʸ֤Ѵ롣
Ѵκݤˤ
.I format
ǻꤷեޥåȤѤͤϥݥ
.I tm
ؤ
.B tm
¤Τ˼롣
.I format
ϡ
.BR scanf (3)
ǻȤƤ褦ʡ
եɥǥץȥƥʸǹƤʸǤ롣
ġΥեɥǥץ
.B %
Ȥ³ʸʤꡢ
Ԥ˥եɥǥץ֤Ƥꤹ롣
.I format
ʸ¾Ƥʸˤϡʸ˥ޥåʸʤФʤʤ
եޥåʸˤ㳰Ǥꡢ
ʸ 0 İʾζȥޥå롣
2 ĤΥեɥǥץδ֤ˤϡ
򡦱ѻʤФʤʤ
.PP
\fBstrptime()\fP ؿϡʸ򺸤鱦ؽ롣
Ϥ줿 3 Ĥ (ʸեޥå) ϡ˽롣
ϤեޥåʸȥޥåǤʤ硢ؿߤ롣
ĤΥեޥåʸʸϽʤ
.PP
Ѳǽʥեɥǥץʲ˵󤲤롣
(̾Ȥä) ʸޥå硢
ʸȾʸ϶̤Ӥ롣
ޥå硢 0 ĤƤ⹽ʤɬɬפǤϤʤ
.TP
.B %%
ʸȤƤ
.BR % 
.TP
.BR %a " ޤ " %A
ߤΥǤ̾ (ά̾ޤϴ̾)
.TP
.BR %b " ޤ " %B " ޤ " %h
ߤΥǤη̾ (ά̾ޤϴ̾)
.TP
.B %c
ߤΥǤդȻɽ
.TP
.B %C
1 ǯ (0-99)
.TP
.BR %d " ޤ " %e
 (1-31)
.TP
.B %D
ա%m/%d/%y Ʊ
(ϥꥫշǡ
衼åѤǤä %d/%m/%y ȤȤƤ뤿ˡ
ꥫͰʳˤʶ路롣
ISO 8601 ʤǤ %Y-%m-%d ȤǤ롣)
.TP
.BR %H
 (0-23)
.TP
.BR %I
12 Ǥλ (1-12)
.TP
.B %j
ǯνᤫ̻ (1-366)
.TP
.B %m
ɽη (1-12)
.TP
.B %M
ʬ (0-59)
.TP
.B %n
Ǥդζ
.TP
.B %p
 AM ()  PM () бΡ
(: бΤʤ⤷ʤ)
.TP
.B %r
( AM  PM Ȥä) 12 λ֡
POSIX Ǥ %I:%M:%S %p Ʊ
ߤΥˤ LC_TIME ѡȤ
\fIt_fmt_ampm\fP Ƥʤ硢
ư̤Ǥ롣
.TP
.B %R
%H:%M Ʊ
.TP
.B %S
 (0-60; 60 ϱä򼨤 61 Ǥ)
.TP
.B %t
Ǥդζ
.TP
.B %T
%H:%M:%S Ʊ
.TP
.B %U
򽵤λϤޤȤǯ̻Ǥν (0-53)
1 κǽ 1 ܤκǽ롣
.TP
.B %w
 0 Ȥɽ (0-6)
.TP
.B %W
򽵤λϤޤȤǯ̻Ǥν (0-53)
1 κǽη 1 ܤκǽ롣
.TP
.B %x
աեեޥåȤȤ
.TP
.B %X
λեޥåȤȤ
.TP
.B %y
1 ǯ (0-99)
ꤵʤ硢
ͤ 69-99 ϰϤΤȤ 20 ǯ (1969-1999)
ͤ 00-68 ϰϤΤȤ 21 ǯ (2000-2068) Ȥ롣
.TP
.B %Y
ǯʬޤ (: 1991)
.LP
E  O ȤҤȤȤѹǤեɥǥץ⤢롣
νҤϡ̤ΥեޥåȤͤȤȤؼ롣
̤ΥեޥåȤͤߤΥ¸ߤʤȤϡ
ѹƤʤեɥǥץȤ롣
.LP
E Ҥϡ˰¸դȻ̤ɽ
ʸ˴ޤޤƤ뤳Ȥꤹ롣
.TP
.B %Ec
դȻ˰¸̤ɽȤ
.TP
.B %EC
ǯ () ̾˰¸̤ɽȤ 
.TP
.B %Ex
ա˰¸̤ɽȤ 
.TP
.B %EX
˰¸̤ɽȤ 
.TP
.B %Ey
%EC (ǯΤ) Υեåȡ˰¸̤ɽȤ 
.TP
.B %EY
ʷǯ̤ɽȤ
.LP
O Ҥϡ˰¸̤ΥեޥåȤ
ͤϤ뤳Ȥꤹ롣
.TP
.BR %Od " ޤ " %Oe
νᤫ̻ա˰¸̤οͥܥȤ
0 ƬˤĤƤ褤ɬܤǤϤʤ
.TP
.B %OH
 (24 )˰¸̤οͥܥȤ
.TP
.B %OI
 (12 )˰¸̤οͥܥȤ
.TP
.B %Om
˰¸̤οͥܥȤ
.TP
.B %OM
ʬ˰¸̤οͥܥȤ
.TP
.B %OS
á˰¸̤οͥܥȤ
.TP
.B %OU
ǯνᤫ̻ν (򽵤λϤȤ)
˰¸̤οͥܥȤ
.TP
.B %Ow
ɽ ( 0 Ȥ)
˰¸̤οͥܥȤ
.TP
.B %OW
ǯνᤫ̻ν (򽵤λϤȤ)
˰¸̤οͥܥȤ
.TP
.B %Oy
ǯ (%C Υեå)˰¸̤οͥܥȤ
.LP
̤λﹽ¤ \fItm\fP 
\fI<time.h>\fP ǰʲͤƤ롣
.sp
.RS
.nf
.ne 12
.ta 8n 16n 32n
struct tm {
	int	tm_sec;			/*  */
	int	tm_min;			/* ʬ */
	int	tm_hour;		/*  */
	int	tm_mday;		/*  */
	int	tm_mon;			/*  */
	int	tm_year;		/* ǯ */
	int	tm_wday;		/*  */
	int	tm_yday;		/* ǯ̻ */
	int	tm_isdst;		/* ƻ */
};
.ta
.fi
.RE
.SH ֤
δؿ֤ͤϡؿǽʤäǽʸؤΥݥ󥿤Ǥ롣
եޥåʸɬפʾʸʸ˴ޤޤƤ硢
֤ͤϺǸ˽줿ʸμʸؤ
٤Ƥʸ󤬽줿硢
֤ͤʸκǸΥ̥ʸäƤХȤؤ
\fBstrptime()\fP եޥåʸΤ٤ƤӤ˼Ԥ
顼ä硢ؿ \fBNULL\fP ݥ󥿤֤
.SH 
XPG4, SUSv2, POSIX 1003.1-2001.
.SH 
ʲ \fBstrptime()\fP  \fBstrftime()\fP λˡ򼨤Ƥ롣
.sp
.nf
.ne 12
.ta 8n 16n
#include <stdio.h>
#include <time.h>

int main() {
	struct tm tm;
	char buf[255];

	strptime("2001-11-12 18:31:01", "%Y-%m-%d %H:%M:%S", &tm);
	strftime(buf, sizeof(buf), "%d %b %Y %H:%M", &tm);
	puts(buf);
	return 0;
}
.ta
.fi
.SH "GNU ǤǤγĥ"
оΤˡglibc Ǥ
.B strptime

.B strftime
Ʊեޥåʸ򥵥ݡȤ褦ȤƤ롣
¿ξ硢бեɤᤵ뤬
\fItm\fP եɤѹʤ
Ѳǽʥեޥåʸʲ˼
.TP
.B %F
\fB%Y-%m-%d\fP ƱISO 8601 շ
.TP
.B %g
ISO бǯϴޤޤ (0-99) ϰϡ
.TP
.B %G
ISO бǯ (㤨 1991)
.TP
.B %u
10 ʿɽ (1-7 Ƿ 1 Ȥ)
.TP
.B %V
ISO 8601:1988 Ǥǯ̻ 10 ʿɽǤν (1-53)
1  1 ޤ (Ϥޤ)  4 ʾ夬ޤޤƤϡ
ν 1 Ȥ롣
3 ʲޤޤƤʤϡ1  1 ޤཱུǯκǽνȤơ
ν 1 Ȥ롣
.TP
.B %z
RFC-822/ISO 8601 ɸॿॾꤹ롣
.TP
.B %Z
ॾ̾
.LP
Ʊͤˤơ\fIstrftime\fP  GNU ǤǤγĥΤˡ
%k  %H%l  %I%P  %p Ʊ롣

.TP
.B %s
ǯ (㤨 1970-01-01 00:00:00 UTC) ̻ÿ
äݡȤƤʤ¤ꡢäϥȤʤ
.LP
GNU libc ˤǤϡ2 ĤΥեɴ֤ζɬפʤ
.SH 
.LP
§Ȥơδؿ \fBtm\fP νϤˡ
ꤵ줿ͤΤߤ롣
ĤޤꡢδؿθƤӽФ \fBtm\fP ʤФʤʤ
¾ Unix ƥȤϡ٤ǰۤʤ롣
GNU libc μǤϡŪ˻ꤵʤեɤѹʤ
㳰ȤơǯΤ줫Ǥѹ줿
.IR tm_wday

.IR tm_yday
Ʒ׻롣
.PP
δؿϡlibc 4.6.8 ʹߤǻѤǤ롣
Linux  libc4  libc5 Υ󥯥롼ɥեϡ
δؿΥץȥפ롣
glibc2 Υ󥯥롼ɥեϡ
_XOPEN_SOURCE ޤ _GNU_SOURCE 줿Τߡ
δؿΥץȥפ󶡤롣
.PP
libc 5.4.13 Ǥϡ ( 'n' ޤ 't' ) ϰʤä
ν 'E'  'O' ϼդʤä
ޤ'C' λ 'c' λƱ̣ǰ줿
.PP
\'y' (1 ǯ) λϡlibc4  libc5 Ǥ 20 ǯȤƲᤵ롣
glibc 2.0 Ǥ 1950-2049 ϰϤȤƲᤵ롣
glibc 2.1  1969-2068 ϰϤȤƲᤵ롣
.\" libc4  libc5 Ǥ %I ѤΥɤƤ (glibc ǽ줿;
.\" %OI  glibc 2.2.4 ǽ줿)
.SH Ϣ
.BR time (2),
.BR getdate (3),
.BR scanf (3),
.BR setlocale (3),
.BR strftime (3)