カルチャを"ja-jp"に設定している場合は、和暦年号の書式を指定できます。
次の表は、有効な書式オプション、および日本語カルチャと英語カルチャとの対応付けを示します。
| キーワード | 日本語カルチャ | 英語カルチャ |
| g | 和暦年号名をアルファベットで表示（M、T、S、H、R） | |
| gg | 和暦年号の全角先頭文字（明、大、昭、平、令）を表示 | |
| ggg | 和暦年号を全角完全名（明治、大正、昭和、平成、令和）で表示 | |
| gggg（gの文字をいくつ追加しても同様） | "ggg"と同じ | |
| e | 可能な場合は、和暦年号の年を1桁で表示（1-??） | "y"と同じ |
| ee | 可能な場合は、和暦年号の年を2桁で表示（01-??） | "yy"と同じ |
| eee（eの文字をいくつ追加しても同様） | "ee"と同じ | "yyyy"と同じ |
| y | gの後であればeと同じ。それ以外の場合はenカルチャと同じ | 年を先行ゼロを付けない数値として表示（0 - 99） |
| yy | gの後であればeeと同じ。それ以外の場合はenカルチャと同じ | 年を先行ゼロを付けた数値として表示（00 - 99） |
| yyy | gの後であればeeと同じ。それ以外の場合はenカルチャと同じ | 年を先行ゼロを付けない数値として表示（1 - 9999） |
| yyyy | gの後であればeeと同じ。それ以外の場合はenカルチャと同じ | "yyy"と同じ |
次のサンプルコードは、和暦年号の書式を設定します。
| JavaScript |
コードのコピー
|
|---|---|
| GC.Spread.Common.CultureInfo.eras = [ {name: "明治", abbreviation: "明", symbol: "M", startDate: "1868-09-08", shortcuts: "1,M"}, {name: "大正", abbreviation: "大", symbol: "T", startDate: "1912-07-30", shortcuts: "2,T"}, {name: "昭和", abbreviation: "昭", symbol: "S", startDate: "1926-12-25", shortcuts: "3,S"}, {name: "平成", abbreviation: "平", symbol: "H", startDate: "1989-01-08", shortcuts: "4,H"}, {name: "令和", abbreviation: "令", symbol: "R", startDate: "2019-05-01", shortcuts: "5,R"} ]; |
|
次のサンプルコードは、セル内の日付を書式設定します。
| JavaScript |
コードのコピー
|
|---|---|
| var f = new GC.Spread.Formatter.GeneralFormatter("ggg ee/MM/dd dddd", "ja-jp"); activeSheet.getCell(1,1).formatter(f); activeSheet.getCell(1,1).value(new Date(2014,00,20)); // または GC.Spread.Common.CultureManager.culture("ja-jp"); activeSheet.getCell(1,1).formatter("ggg ee/MM/dd dddd"); activeSheet.getCell(1,1).value(new Date(2014,00,20)); // または activeSheet.getCell(1,1).formatter("[$-411]ggg ee/MM/dd dddd"); activeSheet.getCell(1,1).value(new Date(2014,00,20)); |
|
次のサンプルコードは、令和の最初の年を「1」年と表示します。（例："R1/5/1"）
| JavaScript |
コードのコピー
|
|---|---|
| activeSheet.getCell(1,1).formatter("[<43586]ge/M/d;[>43830]ge/M/d;g\"1\"/M/d"); activeSheet.getCell(1,1).value(new Date(2019,04,01)); |
|