0


为了数清还有几天到周末,我用python绘制了日历

日历的秘密

昨天,在看小侄子写作业的时候,发现了一个秘密:他在“演算纸”(计算数学题用的草纸)上画了非常多的日历。对此我感到了非常的困惑,“这是做什么的?”

后来,经过了我不懈的追问,小侄子终于说出了实情,“在学校太无聊,所以经常画日历,看看还有几天放假。”

哦!原来是这样!虽然这种行为不值得提倡,但是,小侄子想要放假的心情是可以理解的。所以,我决定帮帮他,研究一下怎么用python绘制出日历。

计算节假日

节假日

众所周知,一周有7天,其中周一到周五是工作日,周六周日是双休日。

每年元旦休息1天,春节休息3天,中秋,端午,清明节各休息1天,劳动节休息1天,国庆节休息3天,总共休息11天。

看起来,只要掌握了节日的规律,就可以知道假期了。但是,由于“调休”,周六周日也不总是休息日,其他工作日也可能变成休息日,所以,不能简单的这样做。

那么,要如何才能够计算出哪些日子是假日呢?答案是,必须要等到每年公布节假日才行。然后,根据公布的结果,进行手动标注。这听起来很麻烦,有没有什么更好的办法可以一劳永逸的解决问题呢?

使用中国日历库

安装:

  1. pip install chinesecalendar

升级:

  1. pip install -U chinesecalendar

中国日历是一个现有的库,可以方便的提供每一天是否是中国的节假日,是什么假日。其实现原理是,该日历库的作者为我们标注好了每一年的节假日,只需要调用即可。

  1. import datetime
  2. import calendar
  3. import chinese_calendar as cc
  4. def day_in_month(year, month):
  5. info = []
  6. days_in_month = calendar.monthrange(year, month)[1]
  7. for day in range(1, days_in_month + 1):
  8. date = datetime.datetime(year, month, day)
  9. weekday = date.weekday()
  10. on_holiday, holiday_name = cc.get_holiday_detail(date)
  11. info.append({
  12. "day": f"{year}-{month}-{day}",
  13. "weekday": weekday + 1,
  14. "on_holiday": on_holiday,
  15. "holiday_name": holiday_name
  16. })
  17. return info
  18. print(day_in_month(2024, 11))

不过需要注意的是:由于该库中的节假日都是作者添加的,所以,在不更新升级的情况下,节假日是不会增多的。例如,现在还没有公布2025年的节假日,那么该库就不能处理2025年的节假日。需要在该库更新以后,手动更新该库,才可以用上最新实现,这听起来不太友好。毕竟,如果在网络受限的环境中,或者没有及时更新,即使已经到了新的年份,旧有的程序也不能很好工作。

使用爬虫程序

另一种想法就是,通过发送网络请求,从网络信息上得到最新的节假日信息。这样,信息总是新的,而且,也不需要更新库,就可以一直使用旧有程序(假设网络地址持续有效,且结构没有发生更改)。

当然,我是非常不推荐这种方法的,与之前的方法不同,该方法虽然可以在不主动更新的情况下持续有效,但是没办法用于没有网络的环境。当然更重要的是,未经许可的爬虫行为并非是一种好的行为,如无必要应该尽量减少或者避免。

有一位作者也发布了一个库,用于爬虫的方式得到节假日信息,该库叫做china_calendar,爬取信息的地址选择的便民查询

  1. import china_calendar
  2. is_holiday = china_calendar.is_holiday("2025-01-28")
  3. print(is_holiday)

倒计时工具

计算时间差

虽然倒计时并不算是日历的一部分,但是可以快速帮助我们得知距离某天还有多久(比如说,还有几天放假)。首先,我们可以计算两个日期的时间差。

  1. from datetime import datetime
  2. def calculate_days_difference(date1, date2):
  3. difference = date2 - date1
  4. return difference.days
  5. date1 = datetime(2024, 11, 11)
  6. date2 = datetime(2025, 1, 28)
  7. days_diff = calculate_days_difference(date1, date2)
  8. print(f"两日期相差{days_diff}天")

计算倒计时

当然,如果是计算某个日期距离今天的时间差,就变成了倒计时功能了。

  1. def countdown_to_date(target_date):
  2. today = datetime.now().date()
  3. difference = target_date.date() - today
  4. return difference.days
  5. date = datetime(2025, 1, 28)
  6. days_diff = countdown_to_date(date)
  7. print(f"距离2025年除夕还有{days_diff}天")

绘制日历

画一个日历并不困难,但是想要画的好看,美观,需要考虑的就比较多了。不过,我们也可以用一个现成的日历实现,比如说fullcalendar,其可以在html的页面中,通过js代码,快速绘制一个功能丰富的日历。

我们可以通过script标签引入,然后,通过适当的js代码,就可以得到功能丰富的日历了,比如说,其官方网站提供的例子:

节假日信息的日历

结合之前的chinese_calendar库,我们就可以轻松实现一个带有节假日信息的日历了,我们将背景颜色设置为红色,当作假期。并且,通过flask作为后端,搭建一个web页面。

  1. import datetime
  2. import calendar
  3. import chinese_calendar as cc
  4. from flask import Flask, render_template, request, jsonify
  5. app = Flask(__name__)
  6. def add_holiday_info(year, month):
  7. info = []
  8. days_in_month = calendar.monthrange(year, month)[1]
  9. for day in range(1, days_in_month + 1):
  10. date = datetime.datetime(year, month, day)
  11. on_holiday, holiday_name = cc.get_holiday_detail(date)
  12. if on_holiday:
  13. info.append({
  14. "start": f"{year}-{month:02d}-{day:02d}",
  15. "title": "",
  16. "display": "background",
  17. "backgroundColor": "#ff0000"
  18. })
  19. if holiday_name:
  20. info.append({
  21. "start": f"{year}-{month:02d}-{day:02d}",
  22. "title": holiday_name
  23. })
  24. return info
  25. def add_surrounding_year(year):
  26. info = []
  27. last_year = year - 1
  28. next_year = year + 1
  29. for month in range(1, 13):
  30. try:
  31. info.extend(add_holiday_info(last_year, month))
  32. info.extend(add_holiday_info(year, month))
  33. info.extend(add_holiday_info(next_year, month))
  34. except NotImplementedError as e:
  35. pass
  36. return info
  37. @app.route("/")
  38. def index():
  39. return render_template("index.html")
  40. @app.route("/api/events")
  41. def get_events():
  42. year = int(request.args.get("year"))
  43. return jsonify(add_surrounding_year(year))

同样,我们需要创建一个index.html作为页面

  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>带有假期显示的日历</title>
  6. <script src='https://cdn.jsdelivr.net/npm/fullcalendar@6.1.15/index.global.min.js'></script>
  7. <style>
  8. #calendar {
  9. max-width: 900px;
  10. margin: 0 auto;
  11. }
  12. </style>
  13. <script>
  14. document.addEventListener('DOMContentLoaded', function() {
  15. var calendarEl = document.getElementById('calendar');
  16. var calendar = new FullCalendar.Calendar(calendarEl, {
  17. initialView: 'dayGridMonth',
  18. locale: 'zh-cn',
  19. datesSet: function(info) {
  20. var year = info.start.getFullYear();
  21. var month = ('0' + (info.start.getMonth())).slice(-2);
  22. fetch('/api/events?year=' + year + '&month=' + month)
  23. .then(response => response.json())
  24. .then(events => {
  25. calendar.removeAllEvents();
  26. calendar.addEventSource(events);
  27. })
  28. .catch(error => console.error('Error fetching events:', error));
  29. }
  30. });
  31. calendar.render();
  32. });
  33. </script>
  34. </head>
  35. <body>
  36. <div id="calendar"></div>
  37. </body>
  38. </html>

很好,现在,我们就得到了一个带有节假日信息的日历了!虽然看起来好像和常见的日历不太一样。不过正确且清晰。

添加额外信息

日历上只有节假日信息,肯定不能让人满意,我们还可以在日历上添加一些自己的备注信息,让其在日历上显示出来。对于这个需求,我们不需要改动页面,只需要添加备注信息即可。

  1. import datetime
  2. import calendar
  3. import chinese_calendar as cc
  4. from flask import Flask, render_template, request, jsonify
  5. app = Flask(__name__)
  6. extra_info = [
  7. ("2024-12-12", "双十二购物"),
  8. ("2024-12-21", "冬至活动"),
  9. ("2024-12-24", "约女神看电影"),
  10. ("2024-12-25", "抓捕麋鹿老人")
  11. ]
  12. def add_extra_info():
  13. info = []
  14. for i in extra_info:
  15. info.append({
  16. "start": i[0],
  17. "title": i[1]
  18. })
  19. return info
  20. def add_holiday_info(year, month):
  21. info = []
  22. days_in_month = calendar.monthrange(year, month)[1]
  23. for day in range(1, days_in_month + 1):
  24. date = datetime.datetime(year, month, day)
  25. on_holiday, holiday_name = cc.get_holiday_detail(date)
  26. if on_holiday:
  27. info.append({
  28. "start": f"{year}-{month:02d}-{day:02d}",
  29. "title": "",
  30. "display": "background",
  31. "backgroundColor": "#ff0000"
  32. })
  33. return info
  34. def add_surrounding_year(year):
  35. info = []
  36. last_year = year - 1
  37. next_year = year + 1
  38. for month in range(1, 13):
  39. try:
  40. info.extend(add_holiday_info(last_year, month))
  41. info.extend(add_holiday_info(year, month))
  42. info.extend(add_holiday_info(next_year, month))
  43. except NotImplementedError as e:
  44. pass
  45. return info
  46. def add_all_info(year):
  47. info = []
  48. info.extend(add_extra_info())
  49. info.extend(add_surrounding_year(year))
  50. return info
  51. @app.route("/")
  52. def index():
  53. return render_template("index.html")
  54. @app.route("/api/events")
  55. def get_events():
  56. year = int(request.args.get("year"))
  57. return jsonify(add_all_info(year))

经过简单的修改以后,我们成功添加了备注信息。

引用与致谢

chinese_calendar的pypi地址

china_calendar的pypi地址

fullcalendar的官方地址

P.S.虽然我们成功绘制了日历,但是小侄子看了并不感到开心,“在学校里画日历,也是一种消磨时间的好办法,你都用程序画好了,我在学校干嘛?”,当然是要好好学习啊喂!

标签: python

本文转载自: https://blog.csdn.net/sagegrass/article/details/143196514
版权归原作者 仙草哥哥 所有, 如有侵权,请联系我们删除。

“为了数清还有几天到周末,我用python绘制了日历”的评论:

还没有评论