時間基盤情報-暦変換(和暦の書式)
書式の指定
書式指定子とそれ以外の文字を組み合わせて入力または出力する書式を指定します。和暦では漢数字や干支を利用することができます。
例)出力で ggyK1年(yE)MK1月dK1(dE) と書式を指定した場合、2013年4月1日は 平成二五年(癸巳)四月一日(丁酉) と出力されます。
書式指定子
年号
gg | 入力/出力 | 年号を示します。年号は必ず指定してください。
入力: 南朝(大覚寺統を含む)・北朝(持明院統を含む)双方に対応します。また、年号として天皇(皇后)名を用いている場合、「天皇」(「皇后」)を省略しても解釈します(例:「神武天皇」は「神武」だけでも可)。年号を「紀元」「皇紀」とした場合は、年を神武天皇即位紀元(皇紀)として解釈します。 入力: 南朝・北朝いずれの年号を出力するか変換時に指定してください。 |
年
yyyy | 入力/出力 | 4桁で示される年を解釈または出力します。正負の符号は使えません。
入力: 4桁未満の数字は解釈できません。年が1000未満の場合は上位の桁を0で埋めて4桁にしてください。 出力: 年が1000未満の場合は、上位の桁を0で埋めます。 |
yy | 入力/出力 | 2桁で示される年を解釈または出力します。正負の符号は使えません。
入力: 2桁未満の数字は解釈できません。3桁以上の数字を書いた場合、数字として評価できるところまで読み取ります。 出力: 100の位以上の桁は表示されません。10の位が0の場合は0が表示されます。 |
y | 入力/出力 | 桁数を指定せずに年を解釈または出力します。yyyy、yyの形式のテキスト(10の位以上が0の場合)も解釈します。
入力: 数字として評価できるところまで読み取ります。 出力: 年をそのまま表示します。 |
yE | 入力/出力 | 十干十二支(甲子, 乙丑, 丙寅, 丁卯...)で表現された年を解釈または出力します。 |
yJ | 入力/出力 | 神武天皇即位紀元(皇紀)で表現された年を解釈または出力します。 |
yW | 入力/出力 | 和暦の年を西暦の年に置き換えた数値を解釈または出力します。実際の西暦年とは必ずしも一致しません。 |
yK | 入力/出力 | 漢数字で表現された年を解釈または出力します。
入力: 漢数字で表現されたすべての表現に対応します。 出力: yk1 と同じ出力です。 |
yK1 | 出力 | 下記の漢数字で表現された年を出力します。
一, ..., 一〇, 一一, ..., ニ〇, 二一, ..., 三〇, 三一 |
yK1b | 出力 | 下記の漢数字で表現された年を出力します。yK1と同じですが、一 は 元 に置き換えられます。
元, ..., 一〇, 一一, ..., ニ〇, 二一, ..., 三〇, 三一 |
yK2 | 出力 | 下記の漢数字で表現された年を出力します。
一, ..., 十, 十一, ..., ニ十, 二十一, ..., 三十, 三十一 |
yK2b | 出力 | 下記の漢数字で表現された年を出力します。yK2と同じですが、一 は 元 に置き換えられます。
元, ..., 十, 十一, ..., ニ十, 二十一, ..., 三十, 三十一 |
yK3 | 出力 | 下記の漢数字で表現された年を出力します。
一, ..., 十, 十一, ..., 廿, 廿一, ..., 卅, 卅一 |
yK3b | 出力 | 下記の漢数字で表現された年を出力します。yK3と同じですが、一 は 元 に置き換えられます。
元, ..., 十, 十一, ..., 廿, 廿一, ..., 卅, 卅一 |
ya | 入力 | 入力時に用いるワイルドカードで、y, yE, yJ, yW, yKのいずれかにマッチすることを示します。 |
月
MMMM | 入力/出力 | 月の名称を解釈または出力します。1月、2月...11月、12月の表現になります。閏月は閏01月となります。 |
MMMM0 | 出力 | MMMMの月を表す数字が2ケタで固定されます。01月、02月...11月、12月の表現になります。 |
MMM | 入力/出力 | 省略された月の名称を解釈または出力します。1、2...11、12の表現になります。閏月は閏1となります。 |
MMM0 | 出力 | MMMの月を表す数字が2ケタで固定されます。01、02...11、12の表現になります。 |
MM | 入力/出力 | 2桁で示される月の番号を解釈または出力します。暦間での互換性維持のために設定されていますが、和暦での使用には適しません。代わりにMMM0を使用してください。 |
M | 入力/出力 | 桁を指定せずに月の番号を解釈または出力します。暦間での互換性維持のために設定されていますが、和暦での使用には適しません。代わりにMMMを使用してください。 |
MJ | 入力/出力 | 日本の月名(睦月, 如月, 弥生, 卯月...)で表現された月を解釈または出力します。 |
MK | 入力/出力 | 漢数字で表現された月を解釈または出力します。
入力: 漢数字で表現されたすべての表現に対応します。 出力: Mk1 と同じ出力です。 |
MK1 | 出力 | 下記の漢数字で表現された月を出力します。
一, ..., 一〇, 一一, 一二 |
MK1b | 出力 | 下記の漢数字で表現された月を出力します。MK1と同じですが、一 は 正 に置き換えられます。
正, ..., 一〇, 一一, 一二 |
MK2 | 出力 | 下記の漢数字で表現された月を出力します。
一, ..., 十, 十一, 十二 |
MK2b | 出力 | 下記の漢数字で表現された月を出力します。MK2と同じですが、一 は 正 に置き換えられます。
正, ..., 十, 十一, 十二 |
Ma | 入力 | 入力時に用いるワイルドカードで、MMMM、MMM、MJ、MKのいずれかにマッチすることを示します。 |
日
dd | 入力/出力 | 2桁で示される日を解釈または出力します。
入力: 2桁未満の数字は解釈できません。 出力: 10の位が0の場合は0が表示されます。 |
d | 入力/出力 | 桁を指定せずに日を解釈または出力します。
入力: 数字として評価できれば、最大2桁まで読み取ります。 出力: 日を表す数字をそのまま表示します。 |
dE | 入力/出力 | 十干十二支(甲子, 乙丑, 丙寅, 丁卯...)で表現された日を解釈または出力します。 |
dK | 入力/出力 | 漢数字で表現された日を解釈または出力します。
入力: 漢数字で表現されたすべての表現に対応します。 出力: dK1 と同じ出力です。 |
dK1 | 出力 | 下記の漢数字で表現された年を出力します。
一, ..., 一〇, 一一, ..., ニ〇, 二一, ..., 三〇, 三一 |
dK1b | 出力 | 下記の漢数字で表現された年を出力します。dK1と同じですが、一 は 朔 に、月の最終日は 晦 に置き換えられます。
朔, ..., 一〇, 一一, ..., ニ〇, 二一, ..., 晦 |
dK2 | 出力 | 下記の漢数字で表現された年を出力します。
一, ..., 十, 十一, ..., ニ十, 二十一, ..., 三〇, 三一 |
dK2b | 出力 | 下記の漢数字で表現された年を出力します。dK2と同じですが、一 は 朔 に、月の最終日は 晦 に置き換えられます。
朔, ..., 十, 十一, ..., ニ十, 二十一, ..., 晦 |
dK3 | 出力 | 下記の漢数字で表現された年を出力します。
一, ..., 十, 十一, ..., 廿, 廿一, ..., 卅, 卅一 |
dK3b | 出力 | 下記の漢数字で表現された年を出力します。dK3と同じですが、一 は 朔 に、月の最終日は 晦 に置き換えられます。
朔, ..., 十, 十一, ..., 廿, 廿一, ..., ..., 晦 |
da | 入力 | 入力時に用いるワイルドカードで、d、dE、dKのいずれかにマッチすることを示します。 |
その他
* | 入力 | 入力時に用いるワイルドカードで、0文字以上の何らかの文字を示します(正規表現の .* と同じ)。次の書式指定子で解釈できる表現が現れるまで読み飛ばします。冒頭に置くことはできません。 |
? | 入力 | 入力時に用いるワイルドカードで、何らかの1文字を示します。冒頭に置くことはできません。 |
" | 入力/出力 | "で囲んだ文字は書式指定子として認識せずそのまま解釈または出力されます。"自身を示す場合は、引用符(')で囲うか\"と表現します。 |
' | 入力/出力 | 'で囲んだ文字は書式指定子として認識せずそのまま解釈または出力されます。'自身を示す場合は、引用符(")で囲うか\'と表現します。 |
\ | 入力/出力 | エスケープ文字です。\の直後の文字は書式指定子として認識せずそのまま解釈または出力され、引用符("または')の中でも有効です。\自身は\\と表現します。 |