Rational Developer for System z
COBOL for Windows バージョン 7.5 プログラミング・ガイド


ピクチャー文字項およびストリング

いくつかの日時の呼び出し可能サービスには、ピクチャー文字項 (入力データの形式または出力データの必要な形式を示すテンプレート) を使用します。

表 77. ピクチャー文字項およびストリング
ピクチャー項 説明 有効な値
Y
YY
YYY
ZYY
YYYY
1 桁の年号
2 桁の年号
3 桁の年号
特定元号での 3 桁の年号
4 桁の年号
0 から 9
00 から 99
000 から 999
1 から 999
1582 から 9999
Y は出力に対してのみ有効です。
YY は CEESCEN によって設定された範囲を前提とします。
YYY/ZYY は、<JJJJ><CCCC>、および <CCCCCCCC> とともに使用されます。
<JJJJ> UTF-16 の 16 進数エンコード方式を使用した漢字の日本元号 平成 (NX'5E736210')
昭和 (NX'662D548C')
大正 (NX'59276B63')
明治 (NX'660E6CBB')
YY フィールドに影響します。<JJJJ> が指定されている場合、YY は特定の日本元号の年号を意味します。例えば、1988 年は昭和 63 年に相当します。
MM
ZM
2 桁の月数
1 または 2 桁の月数
01 から 12
1 から 12
 
出力の場合は、先行ゼロが抑制されます。入力の場合は、ZMMM と同じように扱われます。
RRRR
RRRZ
ローマ数字の月数 Ibbb-XIIb (左寄せ) 入力の場合は、ソース・ストリングが大文字変換されます。出力の場合は、大文字のみで行われます。I=Jan、II=Feb、...、XII=Dec
MMM
Mmm
MMMM...M
Mmmm...m
MMMMMMMMMZ
Mmmmmmmmmz
3 文字の月名、大文字
3 文字の月名、大/小文字混合
3 から 20 文字の月名、大文字
3 から 20 文字の月名、大/小文字混合
末尾ブランクは抑制されます。
末尾ブランクは抑制されます。
JAN から DEC
Jan から Dec
JANUARYbb から DECEMBERb
Januarybb から Decemberb
JANUARY から DECEMBER
January から December
入力の場合は、ソース・ストリングが必ず大文字変換されます。出力の場合は、M が大文字、m が小文字を生成します。出力には、ブランク (b) が埋め込まれるか (Z が指定されていない場合)、M の数 (最大 20) まで切り詰められます。
DD
ZD
DDD
2 桁の日付
1 または 2 桁の日付
年間通算日 (ユリウス日付)
01 から 31
1 から 31
001 から 366
出力の場合は、先行ゼロが常に抑制されます。入力の場合は、ZDDD と同じように扱われます。
HH
ZH
2 桁の時間数
1 または 2 桁の時間数
00 から 23
0 から 23
出力の場合は、先行ゼロが抑制されます。入力の場合は、ZHHH と同じように扱われます。AP が指定されている場合の有効値は 01 から 12 です。
MI 分数 00 から 59  
SS 2 番目 00 から 59  
9
99
999
10 分の 1 の秒数
100 分の 1 の秒数
1000 分の 1 の秒数
0 から 9
00 から 99
000 から 999
丸めなし
AP
ap
A.P.
a.p.
AM/PM 標識 AM または PM
am または pm
A.M. または P.M.
a.m. または p.m.
APHH/ZH フィールドに影響します。入力の場合は、ソース・ストリングが必ず大文字変換されます。出力の場合は、AP が大文字、ap が小文字を生成します。
W
WWW
Www
WWW...W
Www...w
WWWWWWWWWZ
Wwwwwwwwwz
1 文字の曜日名
3 文字の曜日名、大文字
3 文字の曜日名、大/小文字混合
3 から 20 文字の曜日名、大文字
3 から 20 文字の曜日名、大/小文字混合
末尾ブランクは抑制されます。
末尾ブランクは抑制されます。
S、M、T、W、T、F、S
SUN から SAT
Sun から Sat
SUNDAYbbb から SATURDAYb
Sundaybbb から Saturdayb
SUNDAY から SATURDAY
Sunday から Saturday
入力の場合は、W が無視されます。出力の場合は、W が大文字、w が小文字を生成します。出力には、ブランクが埋め込まれるか (Z が指定されていない場合)、W の数 (最大 20) まで切り詰められます。
それ以外 区切り文字 X'01'から X'FF'
(X'00' は、日時の呼び出し可能サービスが「内部」使用するために予約済み)
入力の場合は、月、日、年、時間、分、秒、秒の小数部の間の区切り文字として扱われます。出力の場合は、現状のままターゲット・ストリングにコピーされます。
注: ブランク文字は、シンボル b で示されます。

次の表に、<JJJJ> が指定されている場合に日時サービスによって使用される日本元号の定義を示します。

表 78. 日本元号
各日本元号の 1 日目 年号名 UTF-16 の 16 進数エンコード方式を使用した漢字の元号名 有効な年数値
1868-09-08 明治 NX'660E6CBB' 01 から 45
1912-07-30 大正 NX'59276B63' 01 から 15
1926-12-25 昭和 NX'662D548C' 01 から 64
1989-01-08 平成 NX'5E736210' 01 から 999 (01 = 1989)

例: 日時のピクチャー・ストリング


ご利用条件 | フィードバック

Copyright IBM Corporation 1996, 2008.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています。(http://www.eclipse.org)