.\" 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 Í×ÁÇÊ̤λþ¹ï
+.\"WORD: modifier 修正子
+.\"WORD: broken-down time 要素別の時刻
.\"
.TH STRPTIME 3 2009-12-05 "GNU" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O strptime \- convert a string representation of time to a time tm structure
-strptime \- ʸ»úÎó¤Ç¤¢¤é¤ï¤µ¤ì¤Æ¤¤¤ë»þ´Ö¤ò tm ¹½Â¤ÂΤλþ´Ö¤ËÊÑ´¹¤¹¤ë
+strptime \- 文字列であらわされている時間を tm 構造体の時間に変換する
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.\"O .BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */"
-.BR "#define _XOPEN_SOURCE" " /* feature_test_macros(7) »²¾È */"
+.BR "#define _XOPEN_SOURCE" " /* feature_test_macros(7) 参照 */"
.br
.B #include <time.h>
.sp
.BI "char *strptime(const char *" s ", const char *" format ,
.BI "struct tm *" tm );
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O The
.\"O .BR strptime ()
.\"O function is the converse function to
.\"O using the format specified by
.\"O .IR format .
.BR strptime ()
-´Ø¿ô¤Ï
+関数は
.BR strftime (3)
-¤ÎµÕ´Ø¿ô¤Ç¤¢¤ê¡¢¥Ý¥¤¥ó¥¿
+ã\81®é\80\86é\96¢æ\95°ã\81§ã\81\82ã\82\8aã\80\81ã\83\9dã\82¤ã\83³ã\82¿
.I s
-¤¬»Ø¤¹Ê¸»úÎó¤ò»þ´Ö¤ËÊÑ´¹¤¹¤ë¡£
-ÊÑ´¹¤ÎºÝ¤Ë¤Ï
+が指す文字列を時間に変換する。
+変換の際には
.I format
-¤Ç»ØÄꤷ¤¿¥Õ¥©¡¼¥Þ¥Ã¥È¤òÍѤ¤¡¢Ãͤϥݥ¤¥ó¥¿
+ã\81§æ\8c\87å®\9aã\81\97ã\81\9fã\83\95ã\82©ã\83¼ã\83\9eã\83\83ã\83\88ã\82\92ç\94¨ã\81\84ã\80\81å\80¤ã\81¯ã\83\9dã\82¤ã\83³ã\82¿
.I tm
-¤¬»Ø¤¹
+が指す
.I tm
-¹½Â¤ÂΤ˼ý¤á¤é¤ì¤ë¡£
+構造体に収められる。
.\"O Here
.\"O .I format
.\"O is a character string that consists of field descriptors and text characters,
.\"O character followed by another character that specifies the replacement
.\"O for the field descriptor.
.I format
-¤Ï¡¢
+は、
.BR scanf (3)
-¤Ç»È¤ï¤ì¤Æ¤¤¤ë¤è¤¦¤Ê¡¢
-¥Õ¥£¡¼¥ë¥É¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼¤È¥Æ¥¥¹¥Èʸ»ú¤Ç¹½À®¤µ¤ì¤Æ¤¤¤ëʸ»úÎó¤Ç¤¢¤ë¡£
-¸Ä¡¹¤Î¥Õ¥£¡¼¥ë¥É¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼¤Ï
+で使われているような、
+フィールドディスクリプターとテキスト文字で構成されている文字列である。
+個々のフィールドディスクリプターは
.B %
-¤È¤½¤ì¤Ë³¤¯Ê¸»ú¤«¤é¤Ê¤ê¡¢
-¸å¼Ô¤Ë¥Õ¥£¡¼¥ë¥É¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼¤òÃÖ¤´¹¤¨¤ëÆâÍƤò»ØÄꤹ¤ë¡£
+とそれに続く文字からなり、
+後者にフィールドディスクリプターを置き換える内容を指定する。
.\"O All other characters in the
.\"O .I format
.\"O string must have a matching character in the input string,
.\"O There should be white\%space or other alphanumeric characters
.\"O between any two field descriptors.
.I format
-ʸ»úÎóÃæ¤Î¾¤ÎÁ´¤Æ¤Îʸ»ú¤Ë¤Ï¡¢ÆþÎÏʸ»úÎó¤Ë¥Þ¥Ã¥Á¤¹¤ëʸ»ú¤¬¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-¥Õ¥©¡¼¥Þ¥Ã¥Èʸ»úÎóÃæ¤Ë¤¢¤ë¶õÇò¤ÏÎã³°¤Ç¤¢¤ê¡¢
-ÆþÎÏʸ»úÎóÃæ¤Î 0 ¸Ä°Ê¾å¤Î¶õÇò¤È¥Þ¥Ã¥Á¤¹¤ë¡£
-2 ¤Ä¤Î¥Õ¥£¡¼¥ë¥É¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼¤Î´Ö¤Ë¤Ï¡¢
-¶õÇò¡¦±Ñ»ú¡¦¿ô»ú¤¬¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+文字列中の他の全ての文字には、入力文字列にマッチする文字がなければならない。
+フォーマット文字列中にある空白は例外であり、
+入力文字列中の 0 個以上の空白とマッチする。
+2 つのフィールドディスクリプターの間には、
+空白・英字・数字がなければならない。
.PP
.\"O The
.\"O .BR strptime ()
.\"O If the input cannot be matched to the format string the function stops.
.\"O The remainder of the format and input strings are not processed.
.BR strptime ()
-´Ø¿ô¤Ï¡¢ÆþÎÏʸ»úÎó¤òº¸¤«¤é±¦¤Ø½èÍý¤¹¤ë¡£
-ÆþÎϤµ¤ì¤¿ 3 ¤Ä¤ÎÍ×ÁÇ (¶õÇò¡¦Ê¸»ú¡¦¥Õ¥©¡¼¥Þ¥Ã¥È) ¤Ï¡¢½ç¤Ë½èÍý¤µ¤ì¤ë¡£
-ÆþÎϤ¬¥Õ¥©¡¼¥Þ¥Ã¥Èʸ»úÎó¤È¥Þ¥Ã¥Á¤Ç¤¤Ê¤¤¾ì¹ç¡¢´Ø¿ô¤ÏÄä»ß¤¹¤ë¡£
-»Ä¤ê¤Î¥Õ¥©¡¼¥Þ¥Ã¥Èʸ»úÎó¤ÈÆþÎÏʸ»úÎó¤Ï½èÍý¤µ¤ì¤Ê¤¤¡£
+関数は、入力文字列を左から右へ処理する。
+入力された 3 つの要素 (空白・文字・フォーマット) は、順に処理される。
+入力がフォーマット文字列とマッチできない場合、関数は停止する。
+残りのフォーマット文字列と入力文字列は処理されない。
.PP
.\"O The supported input field descriptors are listed below.
.\"O In case a text string (such as a weekday or month name)
.\"O is to be matched, the comparison is case insensitive.
.\"O In case a number is to be matched, leading zeros are
.\"O permitted but not required.
-»ÈÍѲÄǽ¤Ê¥Õ¥£¡¼¥ë¥É¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼¤ò°Ê²¼¤Ëµó¤²¤ë¡£
-(ÍËÆü¤ä·î¤Î̾Á°¤È¤¤¤Ã¤¿) ʸ»úÎó¤ò¥Þ¥Ã¥Á¤µ¤»¤ë¾ì¹ç¡¢
-Âçʸ»ú¤È¾®Ê¸»ú¤Ï¶èÊ̤»¤º¤ËÈæ³Ó¤¹¤ë¡£
-¿ô¤ò¥Þ¥Ã¥Á¤µ¤»¤ë¾ì¹ç¡¢Á°¤Ë 0 ¤ò¤Ä¤±¤Æ¤â¹½¤ï¤Ê¤¤¤¬É¬¤º¤·¤âɬÍפǤϤʤ¤¡£
+使用可能なフィールドディスクリプターを以下に挙げる。
+(曜日や月の名前といった) 文字列をマッチさせる場合、
+大文字と小文字は区別せずに比較する。
+数をマッチさせる場合、前に 0 をつけても構わないが必ずしも必要ではない。
.TP
.B %%
.\"O The
.\"O .B %
.\"O character.
-ʸ»ú¤È¤·¤Æ¤Î
-.BR % ¡£
+文字としての
+.BR % 。
.TP
.\"O .BR %a " or " %A
-.BR %a " ¤Þ¤¿¤Ï " %A
+.BR %a " または " %A
.\"O The weekday name according to the current locale,
.\"O in abbreviated form or the full name.
-¸½ºß¤Î¥í¥±¡¼¥ë¤Ç¤ÎÍËÆü̾ (¾Êά̾¤Þ¤¿¤Ï´°Á´¤Ê̾Á°)¡£
+現在のロケールでの曜日名 (省略名または完全な名前)。
.TP
.\"O .BR %b " or " %B " or " %h
-.BR %b " ¤Þ¤¿¤Ï " %B " ¤Þ¤¿¤Ï " %h
+.BR %b " または " %B " または " %h
.\"O The month name according to the current locale,
.\"O in abbreviated form or the full name.
-¸½ºß¤Î¥í¥±¡¼¥ë¤Ç¤Î·î̾ (¾Êά̾¤Þ¤¿¤Ï´°Á´¤Ê̾Á°)¡£
+現在のロケールでの月名 (省略名または完全な名前)。
.TP
.B %c
.\"O The date and time representation for the current locale.
-¸½ºß¤Î¥í¥±¡¼¥ë¤Ç¤ÎÆüÉդȻþ¹ï¤Îɽ¸½¡£
+現在のロケールでの日付と時刻の表現。
.TP
.B %C
.\"O The century number (0-99).
-1 À¤µªÃæ¤Îǯ (0-99)¡£
+1 世紀中の年 (0-99)。
.TP
.\"O .BR %d " or " %e
-.BR %d " ¤Þ¤¿¤Ï " %e
+.BR %d " または " %e
.\"O The day of month (1-31).
-·îÆâ¤ÎÆüÉÕ (1-31)¡£
+月内の日付 (1-31)。
.TP
.B %D
.\"O Equivalent to
.\"O is widely used in Europe.
.\"O The ISO 8601 standard format is
.\"O .BR %Y-%m-%d .)
-ÆüÉÕ¡£
+日付。
.B %m/%d/%y
-¤ÈƱ¤¸¡£
-(¤³¤ì¤Ï¥¢¥á¥ê¥«¼°¤ÎÆüÉÕ·Á¼°¤Ç¡¢
-¥è¡¼¥í¥Ã¥Ñ¤Ç¤ÏÆäË
+と同じ。
+(これはアメリカ式の日付形式で、
+ヨーロッパでは特に
.B %d/%m/%y
-¤È¤¤¤¦·Á¼°¤¬¹¤¯»È¤ï¤ì¤Æ¤¤¤ë¤¿¤á¤Ë¡¢
-¥¢¥á¥ê¥«¿Í°Ê³°¤Ë¤Ïʶ¤é¤ï¤·¤¯´¶¤¸¤é¤ì¤ë¡£
-ISO 8601 µ¬³Ê¤Ç¤Ï
+という形式が広く使われているために、
+アメリカ人以外には紛らわしく感じられる。
+ISO 8601 規格では
.B %Y-%m-%d
-¤È¤¤¤¦·Á¼°¤Ç¤¢¤ë¡£)
+という形式である。)
.TP
.B %H
.\"O The hour (0-23).
-»þ´Ö (0-23)¡£
+時間 (0-23)。
.TP
.B %I
.\"O The hour on a 12-hour clock (1-12).
-12 »þ´ÖÀ©¤Ç¤Î»þ´Ö (1-12)¡£
+12 時間制での時間 (1-12)。
.TP
.B %j
.\"O The day number in the year (1-366).
-ǯ¤Î½é¤á¤«¤é¤ÎÄÌ»»¤ÎÆüÉÕ (1-366)¡£
+年の初めからの通算の日付 (1-366)。
.TP
.B %m
.\"O The month number (1-12).
-¿ô»úɽ¸½¤Î·î (1-12)¡£
+数字表現の月 (1-12)。
.TP
.B %M
.\"O The minute (0-59).
-ʬ (0-59)¡£
+分 (0-59)。
.TP
.B %n
.\"O Arbitrary whitespace.
-Ǥ°Õ¤Î¶õÇò¡£
+任意の空白。
.TP
.B %p
.\"O The locale's equivalent of AM or PM.
.\"O (Note: there may be none.)
-¥í¥±¡¼¥ë¤Î AM (¸áÁ°) ¤È PM (¸á¸å) ¤ËÂбþ¤¹¤ë¤â¤Î¡£
-(Ãí°Õ: Âбþ¤¹¤ë¤â¤Î¤¬¤Ê¤¤¤«¤â¤·¤ì¤Ê¤¤¡£)
+ロケールの AM (午前) と PM (午後) に対応するもの。
+(注意: 対応するものがないかもしれない。)
.TP
.B %r
.\"O The 12-hour clock time (using the locale's AM or PM).
.\"O .B LC_TIME
.\"O part of the current locale
.\"O then the behavior is undefined.
-(¥í¥±¡¼¥ë¤Î AM ¤È PM ¤ò»È¤Ã¤¿) 12 »þ´ÖÀ©¤Î»þ´Ö¡£
-POSIX ¥í¥±¡¼¥ë¤Ç¤Ï
+(ロケールの AM と PM を使った) 12 時間制の時間。
+POSIX ロケールでは
.B %I:%M:%S %p
-¤ÈƱ¤¸¡£
-¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤¤¤Æ
+と同じ。
+現在のロケールにおいて
.B LC_TIME
-¥Ñ¡¼¥È¤Î
-\fIt_fmt_ampm\fP ¤¬ÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
-Æ°ºî¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£
+パートの
+\fIt_fmt_ampm\fP が定義されていない場合、
+動作は未定義である。
.TP
.B %R
.\"O Equivalent to
.\"O .BR %H:%M .
.B %H:%M
-¤ÈƱ¤¸¡£
+と同じ。
.TP
.B %S
.\"O The second (0-60; 60 may occur for leap seconds;
.\"O earlier also 61 was allowed).
-Éà (0-60; 60 ¤Ï±¼Éäò¼¨¤¹¡£°ÊÁ°¤Ï 61 ¤â»ØÄê¤Ç¤¤¿)¡£
+秒 (0-60; 60 は閏秒を示す。以前は 61 も指定できた)。
.TP
.B %t
.\"O Arbitrary whitespace.
-Ǥ°Õ¤Î¶õÇò¡£
+任意の空白。
.TP
.B %T
.\"O Equivalent to
.\"O .BR %H:%M:%S .
.B %H:%M:%S
-¤ÈƱ¤¸¡£
+と同じ。
.TP
.B %U
.\"O The week number with Sunday the first day of the week (0-53).
.\"O The first Sunday of January is the first day of week 1.
-ÆüÍËÆü¤ò½µ¤Î»Ï¤Þ¤ê¤È¤·¤¿Ç¯ÄÌ»»¤Ç¤Î½µ¿ô (0-53)¡£
-1 ·î¤ÎºÇ½é¤ÎÆüÍËÆü¤òÂè 1 ½µÌܤκǽé¤ÎÆü¤¹¤ë¡£
+日曜日を週の始まりとした年通算での週数 (0-53)。
+1 月の最初の日曜日を第 1 週目の最初の日する。
.TP
.B %w
.\"O The weekday number (0-6) with Sunday = 0.
-ÆüÍËÆü¤ò 0 ¤È¤·¤¿¿ô»úɽµ¤ÎÍËÆü (0-6)¡£
+日曜日を 0 とした数字表記の曜日 (0-6)。
.TP
.B %W
.\"O The week number with Monday the first day of the week (0-53).
.\"O The first Monday of January is the first day of week 1.
-·îÍËÆü¤ò½µ¤Î»Ï¤Þ¤ê¤È¤·¤¿Ç¯ÄÌ»»¤Ç¤Î½µ¿ô (0-53)¡£
-1 ·î¤ÎºÇ½é¤Î·îÍËÆü¤òÂè 1 ½µÌܤκǽé¤ÎÆü¤¹¤ë¡£
+月曜日を週の始まりとした年通算での週数 (0-53)。
+1 月の最初の月曜日を第 1 週目の最初の日する。
.TP
.B %x
.\"O The date, using the locale's date format.
-ÆüÉÕ¡£¥í¥±¡¼¥ë¤ÎÆüÉÕ¥Õ¥©¡¼¥Þ¥Ã¥È¤ò»È¤¦¡£
+日付。ロケールの日付フォーマットを使う。
.TP
.B %X
.\"O The time, using the locale's time format.
-»þ¹ï¡£¥í¥±¡¼¥ë¤Î»þ¹ï¥Õ¥©¡¼¥Þ¥Ã¥È¤ò»È¤¦¡£
+時刻。ロケールの時刻フォーマットを使う。
.TP
.B %y
.\"O The year within century (0-99).
.\"O When a century is not otherwise specified, values in the range 69-99 refer
.\"O to years in the twentieth century (1969-1999); values in the
.\"O range 00-68 refer to years in the twenty-first century (2000-2068).
-1 À¤µªÃæ¤Îǯ (0-99)¡£
-À¤µª¤¬»ØÄꤵ¤ì¤Ê¤¤¾ì¹ç¡¢
-Ãͤ¬ 69-99 ¤ÎÈϰϤΤȤ¤Ï 20 À¤µª¤Îǯ (1969-1999)¡¢
-Ãͤ¬ 00-68 ¤ÎÈϰϤΤȤ¤Ï 21 À¤µª¤Îǯ (2000-2068) ¤È¤¹¤ë¡£
+1 世紀中の年 (0-99)。
+世紀が指定されない場合、
+値が 69-99 の範囲のときは 20 世紀の年 (1969-1999)、
+値が 00-68 の範囲のときは 21 世紀の年 (2000-2068) とする。
.TP
.B %Y
.\"O The year, including century (for example, 1991).
-ǯ¡£À¤µª¤ÎÉôʬ¤ò´Þ¤à (Îã: 1991)¡£
+年。世紀の部分を含む (例: 1991)。
.LP
.\"O Some field descriptors can be modified by the E or O modifier characters
.\"O to indicate that an alternative format or specification should be used.
.\"O If the
.\"O alternative format or specification does not exist in the current locale, the
.\"O unmodified field descriptor is used.
-E ¤ä O ¤È¤¤¤¦½¤Àµ»Ò¤ò»È¤¦¤³¤È¤ÇÊѹ¹¤Ç¤¤ë¥Õ¥£¡¼¥ë¥É¥Ç¥£¥¹¥¯¥ê¥×¥¿¤â¤¢¤ë¡£
-¤³¤ì¤é¤Î½¤Àµ»Ò¤Ï¡¢Ê̤Υե©¡¼¥Þ¥Ã¥È¤ä»ÅÍͤò»È¤¦¤³¤È¤ò»Ø¼¨¤¹¤ë¡£
-Ê̤Υե©¡¼¥Þ¥Ã¥È¤ä»ÅÍͤ¬¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¸ºß¤·¤Ê¤¤¤È¤¤Ï¡¢
-Êѹ¹¤·¤Æ¤¤¤Ê¤¤¥Õ¥£¡¼¥ë¥É¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬»È¤ï¤ì¤ë¡£
+E や O という修正子を使うことで変更できるフィールドディスクリプタもある。
+これらの修正子は、別のフォーマットや仕様を使うことを指示する。
+別のフォーマットや仕様が現在のロケールに存在しないときは、
+変更していないフィールドディスクリプタが使われる。
.LP
.\"O The E modifier specifies that the input string may contain
.\"O alternative locale-dependent versions of the date and time representation:
-E ½¤Àµ»Ò¤Ï¡¢¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿ÆüÉդȻþ¹ï¤ÎÊ̤Îɽ¸½·Á¼°¤¬
-ÆþÎÏʸ»úÎó¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ë¤³¤È¤ò»ØÄꤹ¤ë¡£
+E 修正子は、ロケールに依存した日付と時刻の別の表現形式が
+入力文字列に含まれていることを指定する。
.TP
.B %Ec
.\"O The locale's alternative date and time representation.
-ÆüÉդȻþ¹ï¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤Îɽ¸½·Á¼°¤ò»È¤¦¡£
+日付と時刻。ロケールに依存した別の表現形式を使う。
.TP
.B %EC
.\"O The name of the base year (period) in the locale's alternative representation.
-´ð½àǯ (´ü´Ö) ¤Î̾Á°¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤Îɽ¸½·Á¼°¤ò»È¤¦¡£
+基準年 (期間) の名前。ロケールに依存した別の表現形式を使う。
.TP
.B %Ex
.\"O The locale's alternative date representation.
-ÆüÉÕ¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤Îɽ¸½·Á¼°¤ò»È¤¦¡£
+日付。ロケールに依存した別の表現形式を使う。
.TP
.B %EX
.\"O The locale's alternative time representation.
-»þ¹ï¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤Îɽ¸½·Á¼°¤ò»È¤¦¡£
+時刻。ロケールに依存した別の表現形式を使う。
.TP
.B %Ey
.\"O The offset from
.\"O .B %EC
.\"O (year only) in the locale's alternative representation.
.B %EC
-(ǯ¤Î¤ß) ¤«¤é¤Î¥ª¥Õ¥»¥Ã¥È¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤Îɽ¸½·Á¼°¤ò»È¤¦¡£
+(年のみ) からのオフセット。ロケールに依存した別の表現形式を使う。
.TP
.B %EY
.\"O The full alternative year representation.
-´°Á´¤Ê·Á¼°¤Îǯ¡£Ê̤Îɽ¸½·¿¼°¤ò»È¤¦¡£
+完全な形式の年。別の表現型式を使う。
.LP
.\"O The O modifier specifies that the numerical input may be in an
.\"O alternative locale-dependent format:
-O ½¤Àµ»Ò¤Ï¡¢¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤Υե©¡¼¥Þ¥Ã¥È¤ÎÃæ¤Ë
-¿ôÃͤÎÆþÎϤ¬¤¢¤ë¤³¤È¤ò»ØÄꤹ¤ë¡£
+O 修正子は、ロケールに依存した別のフォーマットの中に
+数値の入力があることを指定する。
.TP
.\"O .BR %Od " or " %Oe
-.BR %Od " ¤Þ¤¿¤Ï " %Oe
+.BR %Od " または " %Oe
.\"O The day of the month using the locale's alternative numeric symbols;
.\"O leading zeros are permitted but not required.
-·î¤Î½é¤á¤«¤é¤ÎÄÌ»»¤ÎÆüÉÕ¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
-0 ¤òƬ¤Ë¤Ä¤±¤Æ¤â¤è¤¤¤¬¡¢É¬¿Ü¤Ç¤Ï¤Ê¤¤¡£
+月の初めからの通算の日付。ロケールに依存した別の数値シンボルを使う。
+0 を頭につけてもよいが、必須ではない。
.TP
.B %OH
.\"O The hour (24-hour clock) using the locale's alternative numeric symbols.
-»þ´Ö (24 »þ´ÖÀ©)¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+時間 (24 時間制)。ロケールに依存した別の数値シンボルを使う。
.TP
.B %OI
.\"O The hour (12-hour clock) using the locale's alternative numeric symbols.
-»þ´Ö (12 »þ´ÖÀ©)¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+時間 (12 時間制)。ロケールに依存した別の数値シンボルを使う。
.TP
.B %Om
.\"O The month using the locale's alternative numeric symbols.
-·î¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+月。ロケールに依存した別の数値シンボルを使う。
.TP
.B %OM
.\"O The minutes using the locale's alternative numeric symbols.
-ʬ¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+分。ロケールに依存した別の数値シンボルを使う。
.TP
.B %OS
.\"O The seconds using the locale's alternative numeric symbols.
-Éá£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+秒。ロケールに依存した別の数値シンボルを使う。
.TP
.B %OU
.\"O The week number of the year (Sunday as the first day of the week)
.\"O using the locale's alternative numeric symbols.
-ǯ¤Î½é¤á¤«¤é¤ÎÄÌ»»¤Î½µ¿ô (ÆüÍËÆü¤ò½µ¤Î»Ï¤á¤È¤¹¤ë)¡£
-¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+年の初めからの通算の週数 (日曜日を週の始めとする)。
+ロケールに依存した別の数値シンボルを使う。
.TP
.B %Ow
.\"O The number of the weekday (Sunday=0) using the locale's alternative
.\"O numeric symbols.
-¿ôÃÍɽµ¤ÎÍËÆü (ÆüÍËÆü¤ò 0 ¤È¤¹¤ë)¡£
-¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+数値表記の曜日 (日曜日を 0 とする)。
+ロケールに依存した別の数値シンボルを使う。
.TP
.B %OW
.\"O The week number of the year (Monday as the first day of the week)
.\"O using the locale's alternative numeric symbols.
-ǯ¤Î½é¤á¤«¤é¤ÎÄÌ»»¤Î½µ¿ô (·îÍËÆü¤ò½µ¤Î»Ï¤á¤È¤¹¤ë)¡£
-¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+年の初めからの通算の週数 (月曜日を週の始めとする)。
+ロケールに依存した別の数値シンボルを使う。
.TP
.B %Oy
.\"O The year (offset from %C) using the locale's alternative numeric symbols.
.\"O The year (offset from
.\"O .BR %C )
.\"O using the locale's alternative numeric symbols.
-ǯ
+年
.RB ( %C
-¤«¤é¤Î¥ª¥Õ¥»¥Ã¥È)¡£¥í¥±¡¼¥ë¤Ë°Í¸¤·¤¿Ê̤οôÃÍ¥·¥ó¥Ü¥ë¤ò»È¤¦¡£
+からのオフセット)。ロケールに依存した別の数値シンボルを使う。
.LP
.\"O The broken-down time structure \fItm\fP is defined in \fI<time.h>\fP
.\"O as follows:
-Í×ÁÇÊ̤λþ¹ï¹½Â¤ÂÎ \fItm\fP ¤Ï
-\fI<time.h>\fP Æâ¤Ç°Ê²¼¤ÎÍͤËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
+要素別の時刻構造体 \fItm\fP は
+\fI<time.h>\fP 内で以下の様に定義されている。
.sp
.in +4n
.nf
.\"O int tm_isdst; /* daylight saving time */
.\"O };
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; /* ²Æ»þ´Ö */
+ 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
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O The return value of the function is a pointer to the first character
.\"O not processed in this function call.
.\"O In case the input string
.\"O fails to match all
.\"O of the format string and therefore an error occurred the function
.\"O returns NULL.
-¤³¤Î´Ø¿ô¤ÎÊÖ¤êÃͤϡ¢´Ø¿ô¤ÎÃæ¤Ç½èÍý¤µ¤ì¤Ê¤«¤Ã¤¿ºÇ½é¤Îʸ»ú¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£
-¥Õ¥©¡¼¥Þ¥Ã¥Èʸ»úÎó¤¬É¬Íפ¹¤ë°Ê¾å¤Îʸ»ú¤¬ÆþÎÏʸ»úÎó¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ë¾ì¹ç¡¢
-ÊÖ¤êÃͤϺǸå¤Ë½èÍý¤µ¤ì¤¿ÆþÎÏʸ»ú¤Î¼¡¤Îʸ»ú¤ò»Ø¤¹¡£
-¤¹¤Ù¤Æ¤ÎÆþÎÏʸ»úÎ󤬽èÍý¤µ¤ì¤¿¾ì¹ç¡¢
-ÊÖ¤êÃͤÏʸ»úÎóËöÈø¤Î NULL ¥Ð¥¤¥È¤ò»Ø¤¹¡£
+この関数の返り値は、関数の中で処理されなかった最初の文字へのポインタである。
+フォーマット文字列が必要する以上の文字が入力文字列に含まれている場合、
+返り値は最後に処理された入力文字の次の文字を指す。
+すべての入力文字列が処理された場合、
+返り値は文字列末尾の NULL バイトを指す。
.BR strptime ()
-¤¬¥Õ¥©¡¼¥Þ¥Ã¥Èʸ»úÎó¤Î¤¹¤Ù¤Æ¤ÎÈæ³Ó¤Ë¼ºÇÔ¤·¡¢
-¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¡¢´Ø¿ô¤Ï NULL ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
+がフォーマット文字列のすべての比較に失敗し、
+エラーが起こった場合、関数は NULL ポインタを返す。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
SUSv2, POSIX.1-2001.
.\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
.LP
.\"O In principle, this function does not initialize \fItm\fP but
.\"O only stores the values specified.
.\"O and
.\"O .I tm_yday
.\"O field if any of the year, month, or day elements changed.
-¸¶Â§¤È¤·¤Æ¡¢¤³¤Î´Ø¿ô¤Ï \fItm\fP ¤Î½é´ü²½¤Ï¤»¤º¤Ë¡¢
-»ØÄꤵ¤ì¤¿ÃͤΤߤòÆþ¤ì¤ë¡£
-¤Ä¤Þ¤ê¡¢¤³¤Î´Ø¿ô¤Î¸Æ¤Ó½Ð¤·¤ÎÁ°¤Ë \fItm\fP ¤ò½é´ü²½¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-¾¤Î UNIX ¥·¥¹¥Æ¥à¤È¤Ï¡¢ºÙ¤«¤¤ÅÀ¤Ç°Û¤Ê¤ë¡£
-glibc ¤Î¼ÂÁõ¤Ç¤Ï¡¢ÌÀ¼¨Åª¤Ë»ØÄꤵ¤ì¤Ê¤¤¥Õ¥£¡¼¥ë¥É¤ÏÊѹ¹¤µ¤ì¤Ê¤¤¡£
-Îã³°¤È¤·¤Æ¡¢Ç¯¡¦·î¡¦Æü¤Î¤¤¤º¤ì¤«¤ÎÍ×ÁǤ¬Êѹ¹¤µ¤ì¤¿¾ì¹ç¤Ë
+原則として、この関数は \fItm\fP の初期化はせずに、
+指定された値のみを入れる。
+つまり、この関数の呼び出しの前に \fItm\fP を初期化しなければならない。
+他の UNIX システムとは、細かい点で異なる。
+glibc の実装では、明示的に指定されないフィールドは変更されない。
+例外として、年・月・日のいずれかの要素が変更された場合に
.I tm_wday
-¤È
+と
.I tm_yday
-¤¬ºÆ·×»»¤µ¤ì¤ë¡£
+が再計算される。
.PP
.\"O This function is available since libc 4.6.8.
.\"O Linux libc4 and libc5 includes define the prototype unconditionally;
.\"O or
.\"O .B _GNU_SOURCE
.\"O are defined.
-¤³¤Î´Ø¿ô¤Ï¡¢libc 4.6.8 °Ê¹ß¤Ç»ÈÍѤǤ¤ë¡£
-Linux ¤Î libc4 ¤È libc5 ¤Î¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë¤Ï¡¢
-¤³¤Î´Ø¿ô¤Î¥×¥í¥È¥¿¥¤¥×¤ò¾ï¤ËÄêµÁ¤¹¤ë¡£
-glibc2 ¤Î¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë¤Ï¡¢
+この関数は、libc 4.6.8 以降で使用できる。
+Linux の libc4 と libc5 のインクルードファイルは、
+この関数のプロトタイプを常に定義する。
+glibc2 のインクルードファイルは、
.B _XOPEN_SOURCE
-¤Þ¤¿¤Ï
+または
.B _GNU_SOURCE
-¤¬ÄêµÁ¤µ¤ì¤¿¾ì¹ç¤Î¤ß¡¢
-¤³¤Î´Ø¿ô¤Î¥×¥í¥È¥¿¥¤¥×¤òÄ󶡤¹¤ë¡£
+が定義された場合のみ、
+この関数のプロトタイプを提供する。
.PP
.\"O Before libc 5.4.13 whitespace
.\"O (and the \(aqn\(aq and \(aqt\(aq specifications) was not handled,
.\"O no \(aqE\(aq and \(aqO\(aq locale modifier characters were accepted,
.\"O and the \(aqC\(aq specification was a synonym for the \(aqc\(aq specification.
-libc 5.4.13 ¤è¤êÁ°¤Ç¤Ï¡¢¶õÇò (¤È \(aqn\(aq ¤Þ¤¿¤Ï \(aqt\(aq »ØÄê) ¤Ï°·¤ï¤ì¤Ê¤«¤Ã¤¿¡£
-¥í¥±¡¼¥ë¤Î½¤Àµ»Ò \(aqE\(aq ¤È \(aqO\(aq ¤Ï¼õ¤±ÉÕ¤±¤é¤ì¤Ê¤«¤Ã¤¿¡£
-¤Þ¤¿¡¢\(aqC\(aq ¤Î»ØÄê¤Ï \(aqc\(aq ¤Î»ØÄê¤ÈƱ¤¸°ÕÌ£¤Ç°·¤ï¤ì¤¿¡£
+libc 5.4.13 より前では、空白 (と \(aqn\(aq または \(aqt\(aq 指定) は扱われなかった。
+ロケールの修正子 \(aqE\(aq と \(aqO\(aq は受け付けられなかった。
+また、\(aqC\(aq の指定は \(aqc\(aq の指定と同じ意味で扱われた。
.PP
.\"O The \(aqy\(aq (year in century) specification is taken to specify a year
.\"O in the 20th century by libc4 and libc5.
.\"O in the range 1950-2049 by glibc 2.0.
.\"O It is taken to be a year in
.\"O 1969-2068 since glibc 2.1.
-\(aqy\(aq (1 À¤µªÃæ¤Îǯ) ¤Î»ØÄê¤Ï¡¢libc4 ¤È libc5 ¤Ç¤Ï 20 À¤µª¤Îǯ¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£
-glibc 2.0 ¤Ç¤Ï 1950-2049 ¤ÎÈϰϤȤ·¤Æ²ò¼á¤µ¤ì¤ë¡£
-glibc 2.1 ¤«¤é¤Ï 1969-2068 ¤ÎÈϰϤȤ·¤Æ²ò¼á¤µ¤ì¤ë¡£
+\(aqy\(aq (1 世紀中の年) の指定は、libc4 と libc5 では 20 世紀の年として解釈される。
+glibc 2.0 では 1950-2049 の範囲として解釈される。
+glibc 2.1 からは 1969-2068 の範囲として解釈される。
.\"O .\" In libc4 and libc5 the code for %I is broken (fixed in glibc;
.\"O .\" %OI was fixed in glibc 2.2.4).
-.\" libc4 ¤È libc5 ¤Ç¤Ï %I ÍѤΥ³¡¼¥É¤¬²õ¤ì¤Æ¤¤¤ë (glibc ¤Ç½¤Àµ¤µ¤ì¤¿;
-.\" %OI ¤Ï glibc 2.2.4 ¤Ç½¤Àµ¤µ¤ì¤¿)¡£
+.\" libc4 と libc5 では %I 用のコードが壊れている (glibc で修正された;
+.\" %OI は glibc 2.2.4 で修正された)。
.\"O .SS Glibc Notes
-.SS glibc ¤Ç¤ÎÃí°Õ
+.SS glibc での注意
.\"O For reasons of symmetry, glibc tries to support for
.\"O .BR strptime ()
.\"O the same format characters as for
.\"O .BR strftime (3).
-ÂоÝÀ¤Î¤¿¤á¤Ë¡¢glibc ¤Ç¤Ï
+対象性のために、glibc では
.BR strptime ()
-¤Ë
+に
.BR strftime (3)
-¤ÈƱ¤¸¥Õ¥©¡¼¥Þ¥Ã¥Èʸ»ú¤ò¥µ¥Ý¡¼¥È¤µ¤»¤è¤¦¤È¤·¤Æ¤¤¤ë¡£
+と同じフォーマット文字をサポートさせようとしている。
.\"O In most cases the corresponding fields are parsed, but no field in \fItm\fP
.\"O is changed.)
.\"O This leads to
-¿¤¯¤Î¾ì¹ç¡¢Âбþ¤¹¤ë¥Õ¥£¡¼¥ë¥É¤¬²ò¼á¤µ¤ì¤ë¤¬¡¢
-\fItm\fP ¥Õ¥£¡¼¥ë¥É¤ÏÊѹ¹¤µ¤ì¤Ê¤¤¡£
-»ÈÍѲÄǽ¤Ê¥Õ¥©¡¼¥Þ¥Ã¥Èʸ»ú¤ò°Ê²¼¤Ë¼¨¤¹¡£
+多くの場合、対応するフィールドが解釈されるが、
+\fItm\fP フィールドは変更されない。
+使用可能なフォーマット文字を以下に示す。
.TP
.B %F
.\"O Equivalent to \fB%Y-%m-%d\fP, the ISO 8601 date format.
-\fB%Y-%m-%d\fP ¤ÈƱ¤¸¡£ISO 8601 ¤ÎÆüÉÕ·Á¼°¡£
+\fB%Y-%m-%d\fP と同じ。ISO 8601 の日付形式。
.TP
.B %g
.\"O The year corresponding to the ISO week number, but without the century
.\"O (0-99).
-ISO ½µ¿ô¤ËÂбþ¤·¤¿À¾Îñǯ¡£À¤µª¤Ï´Þ¤Þ¤º (0-99) ¤ÎÈÏ°Ï¡£
+ISO 週数に対応した西暦年。世紀は含まず (0-99) の範囲。
.TP
.B %G
.\"O The year corresponding to the ISO week number.
.\"O (For example, 1991.)
-ISO ½µ¿ô¤ËÂбþ¤·¤¿À¾Îñǯ (Î㤨¤Ð 1991)¡£
+ISO 週数に対応した西暦年 (例えば 1991)。
.TP
.B %u
.\"O The day of the week as a decimal number (1-7, where Monday = 1).
-10 ¿Ê¿ôɽµ¤ÎÍËÆü (1-7 ¤Ç·îÍËÆü¤ò 1 ¤È¤¹¤ë)¡£
+10 進数表記の曜日 (1-7 で月曜日を 1 とする)。
.TP
.B %V
.\"O The ISO 8601:1988 week number as a decimal number (1-53).
.\"O in the new year, then it is considered week 1.
.\"O Otherwise, it is the last week
.\"O of the previous year, and the next week is week 1.
-ISO 8601:1988 ·Á¼°¤Ç¤ÎǯÄÌ»»¤Î 10 ¿Ê¿ôɽµ¤Ç¤Î½µ¿ô (1-53)¡£
-1 ·î 1 Æü¤ò´Þ¤à (·îÍËÆü¤«¤é»Ï¤Þ¤ë) ½µ¤Ë 4 Æü°Ê¾å¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢
-¤½¤Î½µ¤òÂè 1 ½µ¤È¤¹¤ë¡£
-3 Æü°Ê²¼¤·¤«´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ï¡¢1 ·î 1 Æü¤ò´Þ¤à½µ¤òÁ°Ç¯¤ÎºÇ½ª¤Î½µ¤È¤·¤Æ¡¢
-¼¡¤Î½µ¤òÂè 1 ½µ¤È¤¹¤ë¡£
+ISO 8601:1988 形式での年通算の 10 進数表記での週数 (1-53)。
+1 月 1 日を含む (月曜日から始まる) 週に 4 日以上が含まれている場合は、
+その週を第 1 週とする。
+3 日以下しか含まれていない場合は、1 月 1 日を含む週を前年の最終の週として、
+次の週を第 1 週とする。
.TP
.B %z
.\"O An RFC-822/ISO 8601 standard timezone specification.
-RFC-822/ISO 8601 ɸ½à¥¿¥¤¥à¥¾¡¼¥ó¤ò»ØÄꤹ¤ë¡£
+RFC-822/ISO 8601 標準タイムゾーンを指定する。
.TP
.B %Z
.\"O The timezone name.
-¥¿¥¤¥à¥¾¡¼¥ó̾¡£
+タイムゾーン名。
.LP
.\"O Similarly, because of GNU extensions to
.\"O .BR strftime (3),
.\"O .B %P
.\"O is accepted as a synonym for
.\"O .BR %p .
-ƱÍͤˡ¢
+同様に、
.BR strftime (3)
-¤Î GNU ÈǤǤγÈÄ¥¤ËÂбþ¤¹¤ë¤¿¤á¤Ë¡¢
+の GNU 版での拡張に対応するために、
.B %k
-¤Ï
-.B %H¡¢
+は
+.B %H、
.B %P
-¤Ï
+は
.B %p
-¤ÈÅù²Á¤Ë°·¤ï¤ì¤ë¡£¤Þ¤¿¡¢
+と等価に扱われる。また、
.B %l
-¤Ï
+は
.B %I
-¤ÈÅù²Á¤Ë°·¤ï¤ì¤ë¤è¤¦¤Ë¤Ê¤ë¤Ï¤º¤Ç¤¢¤ë¡£
+と等価に扱われるようになるはずである。
.\"O Finally
-¤µ¤é¤Ë°Ê²¼¤âÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
+さらに以下も定義されている。
.TP
.B %s
.\"O The number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
.\"O Leap seconds are not counted unless leap second support is available.
-µª¸µ (Epoch; 1970-01-01 00:00:00 +0000 (UTC)) ¤«¤é¤ÎÄÌ»»¤ÎÉÿô¡£
-±¼É䬥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¸Â¤ê¡¢±¼Éäϥ«¥¦¥ó¥È¤·¤Ê¤¤¡£
+紀元 (Epoch; 1970-01-01 00:00:00 +0000 (UTC)) からの通算の秒数。
+閏秒がサポートされていない限り、閏秒はカウントしない。
.LP
.\"O The glibc implementation does not require whitespace between
.\"O two field descriptors.
-glibc ¤Ë¤ª¤±¤ë¼ÂÁõ¤Ç¤Ï¡¢2 ¤Ä¤Î¥Õ¥£¡¼¥ë¥É´Ö¤Î¶õÇò¤ÏɬÍפʤ¤¡£
+glibc における実装では、2 つのフィールド間の空白は必要ない。
.\"O .SH EXAMPLE
-.SH Îã
+.SH 例
.\"O The following example demonstrates the use of
.\"O .BR strptime ()
.\"O and
.\"O .BR strftime (3).
-°Ê²¼¤ÎÎã¤Ï
+以下の例は
.BR strptime ()
-¤È
+と
.BR strftime (3)
-¤Î»ÈÍÑË¡¤ò¼¨¤·¤Æ¤¤¤ë¡£
+の使用法を示している。
.sp
.nf
#define _XOPEN_SOURCE
}
.fi
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR time (2),
.BR getdate (3),
.BR scanf (3),
OSDN Git Service
