翻译

ezBookkeeping 支持多语言和本地化设置，前端和后端分别有自己的多语言文件。前端多语言文件在 /src/locales/，后端多语言文件在 /pkg/locales/。所有语言文件需要以语言标签（单一语言子标签 或 语言子标签加书写体子标签，例如 en、fr、zh-Hans、zh-Hant）命名。

有关语言标签的更多信息，请参考 RFC56​​46。所有可用语言标签可从这里 IANA registry language-subtag-registry 找到。

为前端增加新语言

1. 复制 /src/locales/en.json 并创建一个以语言标签命名的新文件
2. 在 /src/locales/index.ts 中的 allLanguages 对象中添加键值对，其中键名应当为语言标签，值对象里字段说明如下：
   1. name 为英文的语言名称
   2. displayName 为该语言下的语言名称
   3. alternativeLanguageTag 为 language-region 格式的语言标签（例如 zh-CN），为了兼容一些不支持 language-script 格式语言标签的第三方服务
   4. textDirection 为文字方向，支持 ltr（从左到右）及 rtl（从右到左）
   5. content 字段为该语言的字典对象
3. 翻译每个文字条目

为后端增加新语言

1. 复制 /pkg/locales/en.go 并创建一个以语言标签命名的新文件
2. 在 /pkg/locales/all_locales.go 中的 AllLanguages map 中添加键值对，其中键名应当为语言标签，值对象里的 Content 字段应当为新的语言对象
3. 翻译每个文字条目

国际化

ezBookkeeping 允许用户更改多项区域设置，如日期、时间、数字和货币格式。当用户没有修改时，这些区域设置将使用语言文件中配置的默认值。这些默认值都在语言文件的 default 对象中。

这里是所有需要配置默认值的设置和说明：

项目	所有可用选项	描述
currency	/src/consts/currency.ts 中的 ALL_CURRENCIES	默认货币
firstDayOfWeek	/src/core/datetime.ts 中的 WeekDay	默认每周第一天，支持 Sunday、Monday、Tuesday、Wednesday、Thursday、Friday 和 Saturday
fiscalYearFormat	FiscalYearFormat in /src/core/fiscalyear.ts	默认财年格式，支持 StartYYYY_EndYYYY、StartYYYY_EndYY、StartYY_EndYY、EndYYYY 和 EndYY
calendarDisplayType	/src/core/calendar.ts 中的 CalendarDisplayType	默认日历组件及月份中使用的历法，支持 Gregorian、Buddhist、GregorianWithChinese 和 GregorianWithPersian
dateDisplayType	/src/core/calendar.ts 中的 DateDisplayType	默认日期显示时使用的历法，支持 Gregorian、Buddhist 和 Persian
longDateFormat	/src/core/datetime.ts 中的 LongDateFormat	默认长日期格式，支持 YYYYMMDD（年月日）、MMDDYYYY（月日年） 和 DDMMYYYY（日月年）
shortDateFormat	/src/core/datetime.ts 中的 ShortDateFormat	默认短日期格式，支持 YYYYMMDD（年月日）、MMDDYYYY（月日年） 和 DDMMYYYY（日月年）
longTimeFormat	/src/core/datetime.ts 中的 LongTimeFormat	默认长时间格式，支持 HHMMSS（24小时制）、AHHMMSS（12小时制，上午/下午标识在前） 和 HHMMSSA（12小时制，上午/下午标识在后）
shortTimeFormat	/src/core/datetime.ts 中的 ShortTimeFormat	默认短时间格式，支持 HHMMSS（24小时制）、AHHMMSS（12小时制，上午/下午标识在前） 和 HHMMSSA（12小时制，上午/下午标识在后）
currencyDisplayType	/src/core/currency.ts 中的 CurrencyDisplayType	默认货币显示类型，支持 None、SymbolBeforeAmount、SymbolAfterAmount、SymbolBeforeAmountWithoutSpace、SymbolAfterAmountWithoutSpace、CodeBeforeAmount、CodeAfterAmount、UnitBeforeAmount、UnitAfterAmount、NameBeforeAmount 和 NameAfterAmount
numeralSystem	/src/core/numeral.ts 中的 NumeralSystem	默认数字系统，支持 WesternArabicNumerals、EasternArabicNumerals、PersianDigits、BurmeseNumerals 和 DevanagariNumerals
decimalSeparator	/src/core/numeral.ts 中的 DecimalSeparator	默认小数点，支持 Dot 和 Comma
digitGroupingSymbol	/src/core/numeral.ts 中的 DigitGroupingSymbol	默认数字分组符号，支持 Dot、Comma、Space 和 Apostrophe
digitGrouping	/src/core/numeral.ts 中的 DigitGroupingType	默认数字分组类型，支持 None 和 ThousandsSeparator

另外，各语言文件的 format 对象中定义了各种长度的日期格式（年月日、月日年 及 日月年）和时间格式（24小时制、上午/下午标识在前的12小时制 及 上午/下午标识在后的12小时制），这些格式支持如下的占位符：

占位符	说明	范例
YY	2位数年份	99、00、25
YYYY	4位数年份	1999、2000、2025
M	月份	1、2、11
MM	2位数月份	01、02、11
MMM	月份名称缩写	1月、2月、11月
MMMM	月份名称	一月、二月、十一月
D	每月第几天	1、10、28
DD	2位数每月第几天	01、10、28
dd	星期名称最短缩写	日、一、五
ddd	星期名称缩写	周日、周一、周五
dddd	星期名称	星期日、星期一、星期五
H	24小时制小时	0、13、23
HH	2位数24小时制小时	00、13、23
h	12小时制小时	12、1、11
hh	2位数12小时制小时	12、01、11
m	分钟	0、10、59
mm	2位数分钟	00、10、59
s	秒钟	0、10、59
ss	2位数秒钟	00、10、59
A	上午或下午	上午、下午
Z	时区分钟偏移	+08:00、+00:00、-05:00

上述日期时间格式会在下列场景使用：

项目	使用场景
longDate	多个场景
shortDate	多个场景
longYear	首页总览数据中使用
shortYear	交易和统计分析页面的时间筛选中使用
longYearMonth	交易列表显示月份时使用
shortYearMonth	交易和统计分析页面的时间筛选中使用
longMonthDay	首页总览数据中使用
shortMonthDay	交易和统计分析页面的时间筛选中使用，显示在 shortDate 旁边，格式应该类似于 shortDate
shortDay	交易列表显示日期时使用
longTime	多个场景
shortTime	多个场景

此外，时区的数据来自 nodatime ，时区本地化的名称来自 TimeZoneNames