1# 设置日历和历法 2 3## 使用场景 4 5不同地区的用户使用不同的日历,大多数地区使用公历,也有些地区的用户使用其他日历,例如农历、伊斯兰历或希伯来历。此外,日历上的时间和日期也会随着时区和夏令时的不同而改变。因此,用户应设置符合本地习惯的日历。国际化提供了[Calendar](../reference/apis-localization-kit/js-apis-i18n.md#calendar8)类,可以设置日历类型、日期、年月日、时区、一周的起始日期、一年中第一周的最小天数、判断具体某一天在日历中是否为周末、计算相差天数等。在应用开发过程中,开发者可以根据业务需求选择使用不同功能。 6 7## 开发步骤 8 9以查看公历对应的农历日期为例,说明[Calendar](../reference/apis-localization-kit/js-apis-i18n.md#calendar8)类接口使用方法。 10 111. 导入模块。 12 13 ```ts 14 import { i18n } from '@kit.LocalizationKit'; 15 ``` 16 172. 公历相关用法。 18 19 ```ts 20 let calendar : i18n.Calendar = i18n.getCalendar("zh-Hans", "gregory"); 21 //设置日历对象的日期 22 calendar.setTime(new Date(2022, 5, 13, 8, 0, 0)); 23 calendar.setTime(10540800000); 24 25 // 设置日历对象的年、月、日、时、分、秒 26 calendar.set(2022, 5, 13, 8, 0, 0); 27 28 // 设置日历对象的时区 29 calendar.setTimeZone("Asia/Shanghai"); 30 31 // 获取日历对象的时区 32 let timezone: string = calendar.getTimeZone(); // Asia/Shanghai 33 34 // 获取日历对象的一周起始日 35 let firstDayOfWeek : number = calendar.getFirstDayOfWeek(); // 1 36 37 // 设置每一周的起始日 38 calendar.setFirstDayOfWeek(1); 39 40 // 获取一年中第一周的最小天数 41 let minimalDaysInFirstWeek : number = calendar.getMinimalDaysInFirstWeek(); // 1 42 43 // 设置一年中第一周的最小天数 44 calendar.setMinimalDaysInFirstWeek(3); 45 46 // 获取日历对象中与field相关联的值 47 let value: number = calendar.get("year"); // 2022 48 49 // 获取日历对象本地化名称 50 let calendarName: string = calendar.getDisplayName("zh-Hans"); // 公历 51 52 // 判断指定的日期在日历中是否为周末 53 let isWeekend : boolean= calendar.isWeekend(new Date(2023, 9, 15)); // true 54 55 // 在日历的给定字段进行加减操作 56 calendar.set(2023, 10, 15); 57 calendar.add("date", 2); 58 calendar.get("date"); // 17 59 60 // 比较日历和指定日期相差的天数 61 calendar.compareDays(new Date(2023, 10, 15)); // -3 62 ``` 63 643. 获取公历对应的农历日期。 65 66 ```ts 67 let calendar : i18n.Calendar = i18n.getCalendar("zh-Hans", "chinese"); 68 //将公历信息设置到calendar对象 69 calendar.setTime(new Date(2023, 6, 25, 8, 0, 0)); 70 //获取农历年月日 71 calendar.get("year"); // 返回干支纪年40,范围1-60 72 calendar.get("month"); // 结果为5,指6月 73 calendar.get("date"); // 8日 74 ``` 75 76**表1** 支持的日历类型 77 78| 类型 | 中文名称 | 79| -------- | -------- | 80| buddhist | 佛历 | 81| chinese | 农历 | 82| coptic | 科普特历 | 83| ethiopic | 埃塞俄比亚历 | 84| hebrew | 希伯来历 | 85| gregory | 公历 | 86| indian | 印度历 | 87| islamic_civil | 伊斯兰希吉来历 | 88| islamic_tbla | 伊斯兰天文历 | 89| islamic_umalqura | 伊斯兰历(乌姆库拉) | 90| japanese | 日本历 | 91| persian | 波斯历 | 92<!--RP1--><!--RP1End-->