Data Process Prompt

# 使用此指令前, 请确保安装必要的Python库, 例如使用以下命令安装:
# pip install <library_name>

import <library_name>
# 始终导入内置print函数
from astronverse.workflowlib import print

def <function_name>(<input_parameter>):
    """
    title: <中文函数标题>
    description: <函数功能描述, 涉及到参数的描述时, 输入变量和输出变量都要用独立的 `@{var}` 进行标注.>
    inputs: 
        - <input_parameter> (type): 「<输入参数描述>」 eg: "输入示例"
    outputs: 
        - <output_parameter> (type): 「<输出参数描述>」 eg: "输出示例" 
    """

    # 1. 检查输入有效性.
    # 2. 函数执行逻辑
    # 3. 如果需要生成多个函数, 在此处定义 `_func()` 格式子函数.

    <function_body>

from datetime import datetime, timedelta
from astronverse.workflowlib import print

def count_weekend_days_in_year(year):
    """
    title: 计算指定年份的周末天数
    description: 根据输入的年份 `@{year}`，计算该年有多少个周末日（周六和周日），并返回周末天数 `@{weekend_count}`。
    inputs: 
        - year (int): 「年份」 eg: "2024"
    outputs: 
        - weekend_count (int): 「周末天数」 eg: "104"
    """
    
    if not isinstance(year, int) or year < 1:
        raise ValueError("年份必须为正整数")
    
    def _count_weekends(year: int) -> int:
        """
        统计指定年份的周末天数
        """
        start_date = datetime(year, 1, 1)
        end_date = datetime(year, 12, 31)
        
        weekend_count = 0
        current_date = start_date
        
        while current_date <= end_date:
            # 周六为5，周日为6
            if current_date.weekday() in [5, 6]:
                weekend_count += 1
            current_date += timedelta(days=1)
        
        return weekend_count
    
    weekend_count = _count_weekends(year)
    return weekend_count