日曆系統
Vue DatePicker 支援多種日曆系統，基於強大的 @internationalized/date 套件實現國際化日期處理。
支援的日曆系統
| 日曆系統 | 識別碼 | 適用地區/用途 |
|---|---|---|
| 西元曆 | gregory | 國際通用（預設） |
| 中華民國曆 | roc | 台灣地區 |
| 佛曆 | buddhist | 佛教國家 |
| 和曆 | japanese | 日本 |
| 伊斯蘭曆 | islamic-civil | 伊斯蘭國家 |
| 波斯曆 | persian | 伊朗 |
| 希伯來曆 | hebrew | 以色列 |
| 印度曆 | indian | 印度 |
| 其他 | ethiopic, coptic 等 | 特定地區 |
基本使用
--
v-model:
使用上方的互動式範例可以直接體驗不同日曆系統和語言的顯示效果。
重要提醒
- 日期時間輸入功能僅支援
gregory日曆系統 - 輸出格式預設為
iso，如需本地化格式請使用custom - 進階民國曆格式請參考 ROC 格式化插件
年份範圍限制
不同日曆系統有各自的有效年份範圍：
| 日曆系統 | 最小年份 | 最大年份 | 說明 |
|---|---|---|---|
| Gregory | 1 | 當前年+100 | 西元紀年 |
| ROC | 1912 | 當前年+100 | 民國元年對應西元 1912 年 |
| Buddhist | 544 | 當前年+643 | 佛曆紀年比西元早 543 年 |
| Japanese | 1868 | 當前年+100 | 明治維新開始 |
| Islamic | 622 | 當前年+100 | 伊斯蘭紀年 |
| Persian | 622 | 當前年+100 | 波斯紀年 |
| Hebrew | 1 | 當前年+3860 | 希伯來紀年 |
| 其他系統 | 依系統而定 | 詳見 @internationalized/date 文件 |
注意
- 超出範圍的日期可能導致不可預期的行為
- 並非所有瀏覽器都完全支援所有日曆系統
- 建議在生產環境中測試目標瀏覽器的相容性
- 在不支援的環境中會自動回退到西元曆
API 參考
Calendar 相關屬性
| 屬性 | 類型 | 預設值 | 說明 |
|---|---|---|---|
calendar | string | 'gregory' | 日曆系統識別碼 |
locale | string | 'zh-TW' | 語言本地化設定 |
output-type | 'iso' | 'date' | 'object' | 'custom' | 'iso' | 輸出格式類型 |