年号の書式設定

カルチャを"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"と同じ

コードの使用

次のサンプルコードは、和暦年号の書式を設定します。

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"}
];

コードの使用

和暦の最初の年を「元」として表示する「[$-ja-JP-x-gannen]」書式設定と、「1」として表示する「[$-411]ggg e」書式設定を使用できます。次の表は、これらの書式設定の使用方法を示します。

日付	書式設定	結果
2019/12/1	[$-ja-JP-x-gannen]ggg e"年"m"月"d"日"	令和元年12月1日
2019/12/1	[$-411]ggg e"年"m"月"d"日"	令和 1年12月1日

次のサンプルコードは、セル内の日付を書式設定します。

// Spreadを初期化します。
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
// アクティブシートを取得します。
var activeSheet = spread.getActiveSheet();
var date1 = new Date(1989, 1, 8, 2, 3, 7, 325);
var date2 = new Date(2019, 8, 1, 6, 2, 8, 321);
var date3 = new Date(2020, 7, 1, 2, 1, 5, 311);

activeSheet.setValue(0, 0, '[$-411]ggge"年"m"月"d"日" 午前/午後');
activeSheet.setValue(0, 1, date1);
// セル(0,1)の書式を設定します。
activeSheet.setFormatter(0, 1, '[$-411]ggge"年"m"月"d"日" 午前/午後');

activeSheet.setValue(1, 0, '[$-ja-JP-x-gannen]ggg e"年"m"月"d"日"');
activeSheet.setValue(1, 1, date2);
// セル(1,1)の書式を設定します。
activeSheet.setFormatter(1, 1, '[$-ja-JP-x-gannen]ggg e"年"m"月"d"日"');

activeSheet.setValue(2, 0, '[$-411]ggg e"年"m"月"d"日"');
activeSheet.setValue(2, 1, date2);
// セル(2,1)の書式を設定します。
activeSheet.setFormatter(2, 1, '[$-411]ggg e"年"m"月"d"日"');

activeSheet.setValue(3, 0, '[$-ja-JP-x-gannen]ggg e"年"mm"月"dd"日"');
activeSheet.setValue(3, 1, date3);
// セル(3,1)の書式を設定します。
activeSheet.setFormatter(3, 1, '[$-ja-JP-x-gannen]ggg e"年"mm"月"dd"日"');

// 列幅を設定します。
activeSheet.setColumnWidth(0, 300.0, GC.Spread.Sheets.SheetArea.viewport);
activeSheet.setColumnWidth(1, 200.0, GC.Spread.Sheets.SheetArea.viewport);

コードの使用

次のサンプルコードは、令和の最初の年を「1」年と表示します。（例："R1/5/1"）

var f = new GC.Spread.Formatter.GeneralFormatter("[<43586]ge/M/d;[>43830]ge/M/d;g\"1\"/M/d", "ja-jp")
activeSheet.getCell(1,1).formatter(f);
activeSheet.getCell(1,1).value(new Date(2019,04,01));

Spread.Sheetsの既定の動作は、和暦の最初の年を「元」年と表示します。