Linux内核 -- RTC之`struct rtc_time` 字段分析

Linux Kernel 中 struct rtc_time 的 tm_year 字段详解

1. struct rtc_time 的界说

在 Linux 内核中，struct rtc_time 用于表示及时时钟（RTC）时间。其界说如下：

1. struct rtc_time {
2.     int tm_sec;   /* 分钟的秒数 (0-59) */
3.     int tm_min;   /* 小时的分钟数 (0-59) */
4.     int tm_hour;  /* 自午夜起的小时数 (0-23) */
5.     int tm_mday;  /* 月中的某一天 (1-31) */
6.     int tm_mon;   /* 自一月起的月数 (0-11) */
7.     int tm_year;  /* 自1900年以来的年份偏移值 */
8.     int tm_wday;  /* 自星期日起的天数 (0-6) */
9.     int tm_yday;  /* 自一月一日起的天数 (0-365) */
10.     int tm_isdst; /* 夏令时标志 */
11. };

复制代码

2. tm_year 的含义

• tm_year 表示年份的偏移值，其基准年份是 1900。
  
• 换句话说，
  
  
  
  • 如果 tm_year = 123，表示年份为 1900 + 123 = 2023。
    
  • 如果 tm_year = 0，表示年份为 1900 + 0 = 1900。
    
  
  

3. 使用中的注意事项

• 获取时间时：须要将 tm_year 加上 1900，转换为尺度年份。
  
• 设置时间时：须要将尺度年份减去 1900，然后赋值给 tm_year。
  

4. 与用户空间的交互

• 用户空间的尺度库（如 glibc）中界说了类似的布局体 struct tm，其 tm_year 字段的含义与内核的 rtc_time 一致。
  
• 因此，内核中的 struct rtc_time 和用户空间的 struct tm 可以直接转换。
  

5. 现实应用示例

获取时间

1. struct rtc_time tm;
2. rtc_read_time(rtc, &tm);
3. int year = tm.tm_year + 1900; // 转换为标准年份
4. printk("Current year: %d\n", year);

复制代码

设置时间

1. struct rtc_time tm = {
2.     .tm_year = 2023 - 1900,  // 转换标准年份为 tm_year 的值
3.     .tm_mon = 11 - 1,        // 月份，从 0 开始
4.     .tm_mday = 30,
5.     .tm_hour = 12,
6.     .tm_min = 0,
7.     .tm_sec = 0,
8. };
9. rtc_set_time(rtc, &tm);

复制代码

6. 与 RTC 硬件交互

• 及时时钟硬件芯片（如 DS3231）大概以不同格式存储年份。例如，有些芯片仅存储两位数年份（如 00 表示 2000 年）。驱动步伐须要将 RTC 硬件的年份格式转换为 tm_year 的格式。
  
• 如果硬件仅支持 20 世纪和 21 世纪的年份，驱动步伐通常会根据上下文决定世纪部门。
  

7. 常见问题

溢出问题

• 由于 tm_year 是相对于 1900 的偏移值，其理论最大值取决于字段的类型（通常为 int）。
  
• 在 32 位体系中，最大年份范围可达 INT_MAX - 1900。
  

世纪问题

• 某些硬件仅存储两位年份，转换时须要根据当前时间或用户设置推断世纪部门。
  

8. 小结

• tm_year 是从 1900 开始的偏移值。
  
• 获取和设置时间时需举行得当的加减操作以转换为尺度年份。
  
• 与 RTC 硬件交互时，大概须要额外处理惩罚世纪信息。
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。