设置Era格式

如果将区域性设置为“ ja-jp”，则可以指定Era的格式设置。

下表列出了格式选项以及日语和英语的文化等效项。

关键词	日本Culture	英文Culture
g	以字母显示Era名称（M，T，S，H，R）
gg	显示第一个字符（DBCS）era（明，大，昭，平，令）
ggg	显示完整（DBCS）era（明治，大正，昭和，平成，令和）
gggg (plus any additional "g" characters)	与"ggg"相同
e	将nengo年显示为一个数字（1- ??）	与"y"相同
ee	将nengo年显示为两位数字（01- ??）	与"yy"相同
eee (plus any additional "e" characters)	与"ee"相同	与"yyyy"相同
y	在“ g”之后与“ e”相同；否则，与文化相同	将年份显示为没有前导零（0-99）的数字
yy	在“ g”之后与“ ee”相同；否则，与文化相同	将年份显示为带有前导零（00-99）的数字
yyy	在“ g”之后与“ ee”相同；否则，与文化相同	将年份显示为没有前导零的数字（1-9999）
yyyy	在“ g”之后与“ ee”相同；否则，与文化相同	与 "yyy"相同

示例代码

以下示例设置了era格式。

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

示例代码

SpreadJS支持“ [$ -ja-JP-x-gannen]”格式化程序将第一年显示为“元”，并支持“ [$ -411] * ggg e”格式化程序将第一年显示为“ 1”。可以使用以下示例进行解释：

Date	Formatter	Result
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);
// 设置Cell [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);
// 设置Cell [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);
// 设置Cell [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);
// 设置Cell [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);