翻譯日期和時間元件的自訂標籤

使用 JSON 字串和 Omniscript 自訂標籤定義日期和時間選擇器的自訂標籤翻譯。例如,如果已定義西班牙文翻譯,日期選擇器會顯示一週中幾個月與幾天的西班牙文翻譯。

1. 前往 Day.js,按一下「支援地區設定的清單」,然後選擇語言檔案。
2. 在語言的 JavaScript 檔案中,在 locale 物件內複製外部括弧和其間的所有項目。

   例如,在 es-us.js 檔案中,複製醒目提示的文字:

   // Spanish (United States) [es-us]
   import dayjs from 'dayjs'
   
   const locale = {
     name: 'es-us',
     weekdays: 'domingo_lunes_martes_miércoles_jueves_viernes_sábado'.split('_'),
     weekdaysShort: 'dom._lun._mar._mié._jue._vie._sáb.'.split('_'),
     weekdaysMin: 'do_lu_ma_mi_ju_vi_sá'.split('_'),
     months: 'enero_febrero_marzo_abril_mayo_junio_julio_agosto_septiembre_octubre_​noviembre_diciembre'.split('_'),
     monthsShort: 'ene_feb_mar_abr_may_jun_jul_ago_sep_oct_nov_dic'.split('_'),
     relativeTime: {
       future: 'en %s',
       past: 'hace %s',
       s: 'unos segundos',
       m: 'un minuto',
       mm: '%d minutos',
       h: 'una hora',
       hh: '%d horas',
       d: 'un día',
       dd: '%d días',
       M: 'un mes',
       MM: '%d meses',
       y: 'un año',
       yy: '%d años'
     },
     ordinal: n => `${n}º`,
     formats: {
       LT: 'h:mm A',
       LTS: 'h:mm:ss A',
       L: 'MM/DD/YYYY',
       LL: 'D [de] MMMM [de] YYYY',
       LLL: 'D [de] MMMM [de] YYYY h:mm A',
       LLLL: 'dddd, D [de] MMMM [de] YYYY h:mm A'
     }
   }
   
   dayjs.locale(locale, null, true)
   
   export default locale

3. 將您複製的 JavaScript 程式碼貼到 JavaScript 到 JSON 轉換器 (例如 https://www.convertsimple.com/convert-javascript-to-json/) 中,並進行轉換。

   轉換後的 JSON 程式碼如下所示:

   {
     "name": "es-us",
     "weekdays": [
       "domingo",
       "lunes",
       "martes",
       "miércoles",
       "jueves",
       "viernes",
       "sábado"
     ],
     "weekdaysShort": [
       "dom.",
       "lun.",
       "mar.",
       "mié.",
       "jue.",
       "vie.",
       "sáb."
     ],
     "weekdaysMin": [
       "do",
       "lu",
       "ma",
       "mi",
       "ju",
       "vi",
       "sá"
     ],
     "months": [
       "enero",
       "febrero",
       "marzo",
       "abril",
       "mayo",
       "junio",
       "julio",
       "agosto",
       "septiembre",
       "octubre",
       "noviembre",
       "diciembre"
     ],
     "monthsShort": [
       "ene",
       "feb",
       "mar",
       "abr",
       "may",
       "jun",
       "jul",
       "ago",
       "sep",
       "oct",
       "nov",
       "dic"
     ],
     "relativeTime": {
       "future": "en %s",
       "past": "hace %s",
       "s": "unos segundos",
       "m": "un minuto",
       "mm": "%d minutos",
       "h": "una hora",
       "hh": "%d horas",
       "d": "un día",
       "dd": "%d días",
       "M": "un mes",
       "MM": "%d meses",
       "y": "un año",
       "yy": "%d años"
     },
     "formats": {
       "LT": "h:mm A",
       "LTS": "h:mm:ss A",
       "L": "MM/DD/YYYY",
       "LL": "D [de] MMMM [de] YYYY",
       "LLL": "D [de] MMMM [de] YYYY h:mm A",
       "LLLL": "dddd, D [de] MMMM [de] YYYY h:mm A"
     }
   }

   

   備註 某些 JavaScript 到 JSON 轉換器不支援如 relativeTimeFormatter 等函數。如果地區設定使用 relativeTimeFormatter,請移除 relativeTime 金鑰及其括弧內的所有項目,或新增 mm、hh 等值。或者,如果您熟悉 JavaScript,您可以執行 .js 檔案、執行 JSON.stringify(locale) 指令,然後略過下一個步驟。
4. 使用具有「精簡 JSON」或「最小化 JSON」功能 (例如 https://jsoneditoronline.org/) 的 JSON 格式化程式來移除分行符號和額外的空白空間。

   壓縮的 JSON 程式碼如下所示:

   {"name": "es-us", "weekdays": ["domingo", "lunes", "martes", 
   "miércoles", "jueves", "viernes", "sábado"], "weekdaysShort": ["dom.", 
   "lun.", "mar.", "mié.", "jue.", "vie.", "sáb."], "weekdaysMin": ["do", 
   "lu", "ma", "mi", "ju", "vi", "sá"], "months": ["enero", "febrero", 
   "marzo", "abril", "mayo", "junio", "julio", "agosto", "septiembre", 
   "octubre", "noviembre", "diciembre"], "monthsShort": ["ene", "feb", 
   "mar", "abr", "may", "jun", "jul", "ago", "sep", "oct", "nov", "dic"], 
   "relativeTime": {"future": "en %s", "past": "hace %s", "s": 
   "unos segundos", "m": "un minuto", "mm": "%d minutos", "h": "una hora", 
   "hh": "%d horas", "d": "un día", "dd": "%d días", "M": "un mes", "MM": 
   "%d meses", "y": "un año", "yy": "%d años"}, "formats": {"LT": "h:mm A", 
   "LTS": "h:mm:ss A", "L": "MM/DD/YYYY", "LL": "D [de] MMMM [de] YYYY", 
   "LLL": "D [de] MMMM [de] YYYY h:mm A", 
   "LLLL": "dddd, D [de] MMMM [de] YYYY h:mm A"}}

   (已新增一些分行符號以將此指南中的文字換行。)

   

   備註

   自訂標籤僅接受有效的 JSON 字串。

5. 複製精簡的 JSON 程式碼。
6. 進入「設定」,移至「自訂標籤」,然後開啟符合您需求的自訂標籤。

   建議使用下列自訂標籤:

   自訂標籤	描述
   cmpDayJsLocaleFormats	將翻譯套用至 LWC 日期元件和 Omniscript 日期元素。如果 OmniDayJSLocaleFormats 標籤已定義翻譯,則 cmpDayJsLocaleFormats 標籤不會將翻譯套用至 Omniscript。
   OmniDayJsLocaleFormats	僅將翻譯套用至 Omniscript 日期和時間元素。如果兩個自訂標籤都已定義翻譯,則會覆寫 Omniscript 中的 cmpDayJsLocaleFormats 標籤。

7. 在自訂標籤中,按一下「新增」 以新增翻譯。
8. 選取「語言」。
9. 在「翻譯」 欄位中,貼上精簡的 JSON 程式碼。
10. 按一下「儲存」。
    
11. 開啟包含「日期」或「日期/時間」元素的 Omniscript,移至「預覽」,選取語言,然後開啟日期選擇器。
    如果您遵循範例並選取西班牙文,則日期選擇器會顯示當週的月份和日期的西班牙文翻譯。