.\" 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 
.BR strptime ()
ؿ
.BR strftime (3)
εմؿǤꡢݥ
.I s
ؤʸ֤Ѵ롣
Ѵκݤˤ
.I format
ǻꤷեޥåȤѤͤϥݥ
.I tm
ؤ
.I tm
¤Τ˼롣
.I format
ϡ
.BR scanf (3)
ǻȤƤ褦ʡ
եɥǥץȥƥʸǹƤʸǤ롣
ġΥեɥǥץ
.B %
Ȥ³ʸʤꡢ
Ԥ˥եɥǥץ֤Ƥꤹ롣
.I format
ʸ¾Ƥʸˤϡʸ˥ޥåʸʤФʤʤ
եޥåʸˤ㳰Ǥꡢ
ʸ 0 İʾζȥޥå롣
2 ĤΥեɥǥץδ֤ˤϡ
򡦱ѻʤФʤʤ
.PP
.BR strptime ()
ؿϡʸ򺸤鱦ؽ롣
Ϥ줿 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
ա
.B %m/%d/%y
Ʊ
(ϥꥫշǡ
衼åѤǤä
.B %d/%m/%y
ȤȤƤ뤿ˡ
ꥫͰʳˤʶ路롣
ISO 8601 ʤǤ
.B %Y-%m-%d
ȤǤ롣)
.TP
.B %H
 (0-23)
.TP
.B %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 Ǥ
.B %I:%M:%S %p
Ʊ
ߤΥˤ
.B LC_TIME
ѡȤ
\fIt_fmt_ampm\fP Ƥʤ硢
ư̤Ǥ롣
.TP
.B %R
.B %H:%M
Ʊ
.TP
.B %S
 (0-60; 60 ϱä򼨤 61 Ǥ)
.TP
.B %t
Ǥդζ
.TP
.B %T
.B %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
.B %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
ǯ
.RB ( %C
Υեå)˰¸̤οͥܥȤ
.LP
̤λﹽ¤ \fItm\fP 
\fI<time.h>\fP ǰʲͤƤ롣
.sp
.in +4n
.nf
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;      /* ƻ */
};
.fi
.in
.SH ֤
δؿ֤ͤϡؿǽʤäǽʸؤΥݥ󥿤Ǥ롣
եޥåʸɬפʾʸʸ˴ޤޤƤ硢
֤ͤϺǸ˽줿ʸμʸؤ
٤Ƥʸ󤬽줿硢
֤ͤʸ NULL ХȤؤ
.BR strptime ()
եޥåʸΤ٤ƤӤ˼Ԥ
顼ä硢ؿ NULL ݥ󥿤֤
.SH 
SUSv2, POSIX.1-2001.
.SH 
.LP
§Ȥơδؿ \fItm\fP νϤˡ
ꤵ줿ͤΤߤ롣
ĤޤꡢδؿθƤӽФ \fItm\fP ʤФʤʤ
¾ Unix ƥȤϡ٤ǰۤʤ롣
glibc μǤϡŪ˻ꤵʤեɤѹʤ
㳰ȤơǯΤ줫Ǥѹ줿
.I tm_wday

.I tm_yday
Ʒ׻롣
.PP
δؿϡlibc 4.6.8 ʹߤǻѤǤ롣
Linux  libc4  libc5 Υ󥯥롼ɥեϡ
δؿΥץȥפ롣
glibc2 Υ󥯥롼ɥեϡ
.B _XOPEN_SOURCE
ޤ
.B _GNU_SOURCE
줿Τߡ
δؿΥץȥפ󶡤롣
.PP
libc 5.4.13 Ǥϡ ( \(aqn\(aq ޤ \(aqt\(aq ) ϰʤä
ν \(aqE\(aq  \(aqO\(aq ϼդʤä
ޤ\(aqC\(aq λ \(aqc\(aq λƱ̣ǰ줿
.PP
\(aqy\(aq (1 ǯ) λϡlibc4  libc5 Ǥ 20 ǯȤƲᤵ롣
glibc 2.0 Ǥ 1950-2049 ϰϤȤƲᤵ롣
glibc 2.1  1969-2068 ϰϤȤƲᤵ롣
.\" libc4  libc5 Ǥ %I ѤΥɤƤ (glibc ǽ줿;
.\" %OI  glibc 2.2.4 ǽ줿)
.SS glibc Ǥ
оΤˡglibc Ǥ
.BR strptime ()

.BR strftime (3)
Ʊեޥåʸ򥵥ݡȤ褦ȤƤ롣
¿ξ硢бեɤᤵ뤬
\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
Ʊͤˡ
.BR strftime (3)
 GNU ǤǤγĥб뤿ˡ
.B %k

.B %H
.B %P

.B %p
˰롣ޤ
.B %l

.B %I
˰褦ˤʤϤǤ롣

˰ʲƤ롣
.TP
.B %s
ǯ (㤨 1970-01-01 00:00:00 UTC) ̻ÿ
äݡȤƤʤ¤ꡢäϥȤʤ
.LP
glibc ˤǤϡ2 ĤΥեɴ֤ζɬפʤ
.SH 
ʲ
.BR strptime ()

.BR strftime (3)
λˡ򼨤Ƥ롣
.sp
.nf
#define _XOPEN_SOURCE
#include <stdio.h>
#include <stdlib.h>
#include <time.h>

int
main(void)
{
    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);
    exit(EXIT_SUCCESS);
}
.fi
.SH Ϣ
.BR time (2),
.BR getdate (3),
.BR scanf (3),
.BR setlocale (3),
.BR strftime (3),
.BR feature_test_macros (7)