Day.js对国际化有很大的支持。 但是,除非您使用它们,否则它们都不会包含在您的构建中。
您可以加载多个地区并轻松地在它们之间切换。
支持的地区列表:https://github.com/iamkun/dayjs/tree/dev/src/locale
非常欢迎您通过打开一个pull请求来添加区域设置。
# 在NodeJS中加载语言
根据需要加载语言环境。
require('dayjs/locale/de')
// import 'dayjs/locale/de' // ES 2015
dayjs.locale('de') // use locale globally
dayjs().locale('de').format() // use locale in a specific instance
您还可以加载并获取locale对象以供进一步使用。
var locale_de = require('dayjs/locale/de')
// import locale_de from 'dayjs/locale/de' // ES 2015
# 在浏览器中加载语言
根据需要加载语言环境。
<script src="path/to/dayjs/locale/de"></script>
<script>
dayjs.locale('de') // use locale globally
dayjs().locale('de').format() // use locale in a specific instance
</script>
获取locale对象以供进一步使用。
<script src="path/to/dayjs/locale/de"></script>
<!-- Load locale as window.dayjs_locale_NAME -->
<script>
var customLocale = window.dayjs_locale_zh_cn // zh-cn -> zh_cn
</script>
Day.js可在CDN上使用。
<!-- CDN example (unpkg) -->
<script src="https://unpkg.com/dayjs@1.8.21/dayjs.min.js"></script>
<script src="https://unpkg.com/dayjs@1.8.21/locale/zh-cn.js"></script>
<script>dayjs.locale('zh-cn')</script>
# 改变全局语言
默认情况下,Day.js只支持英语(美国)地区。 如果需要其他地区,可以按需加载它们。
require('dayjs/locale/de')
调用dayjs.locale设置,以更改全局语言设置。
改变全局语言环境不会影响现有实例。
dayjs.locale('de') // use loaded locale globally
dayjs.locale('en') // switch back to default English locale globally
# 改变本地语言
在传递可能需要格式化为不同语言环境的日期时间时,全局语言环境配置可能会出现问题。
与dayjs#locale完全相同,但只在特定实例中使用locale,并通过切换到新locale返回一个新实例。
require('dayjs/locale/de')
dayjs().locale('de').format() // use loaded locale locally
# 检查语言设置
返回当前实例的语言环境。
dayjs.locale() // 'en'
# 列出月份和工作日
获取区域设置中的月份或工作日列表。
注意
此功能依赖LocaleData插件
dayjs.extend(localeData)
dayjs.weekdays()
dayjs.weekdaysShort()
dayjs.weekdaysMin()
dayjs.monthsShort()
dayjs.months() // e.g. return [ 'January','February','March','April','May',
// 'June','July','August','September','October','November','December' ]
# 访问特定于语言环境的功能
可以通过dayjs.localedata()函数访问当前加载的语言环境的属性,或者通过dayjs().localedata()访问当前的Day.js对象。
注意
此功能依赖LocaleData插件
dayjs.extend(localeData)
globalLocaleData = dayjs.localeData()
globalLocaleData.firstDayOfWeek()
globalLocaleData.months()
globalLocaleData.monthsShort()
globalLocaleData.weekdays()
globalLocaleData.weekdaysShort()
globalLocaleData.weekdaysMin()
globalLocaleData.months(dayjs())
globalLocaleData.monthsShort(dayjs())
globalLocaleData.weekdays(dayjs())
globalLocaleData.weekdaysShort(dayjs())
globalLocaleData.weekdaysMin(dayjs())
instanceLocaleData = dayjs().localeData()
instanceLocaleData.firstDayOfWeek()
instanceLocaleData.months()
instanceLocaleData.monthsShort()
instanceLocaleData.weekdays()
instanceLocaleData.weekdaysShort()
instanceLocaleData.weekdaysMin()