Python日期处理工具类深度解析

@staticmethod
def get_current_date() -> date:
    """获取当前日期对象（date类型）[1][3]
    Example: 2024-02-15
    """
    return date.today()

@staticmethod
def get_current_datetime() -> datetime:
    """获取当前日期时间对象（datetime类型）[2][3]
    Example: 2024-02-15 14:30:45.123456
    """
    return datetime.now()

@staticmethod
def format_date(dt: date, fmt: str = "%Y-%m-%d") -> str:
    """日期格式化输出[1][2]
    Example: 2024-02-15 → "15/02/2024"
    """
    return dt.strftime(fmt)

@staticmethod
def parse_date_str(date_str: str, fmt: str = "%Y-%m-%d") -> date:
    """字符串转日期对象[2][3]
    Example: "20240215" → 2024-02-15
    """
    return datetime.strptime(date_str, fmt).date()

@staticmethod
def calculate_days_diff(start: date, end: date) -> int:
    """计算两个日期之间的天数差[2]
    Example: 2024-02-10与2024-02-15 → 5天
    """
    return (end - start).days

@staticmethod
def add_days(base_date: date, days: int) -> date:
    """日期加减计算[1][3]
    Example: 2024-02-15 + 3天 → 2024-02-18
    """
    return base_date + timedelta(days=days)

@staticmethod
def get_month_calendar(year: int, month: int) -> str:
    """生成月份日历[4][5]
    Example: 2024年2月 → 返回格式化日历表格
    """
    return calendar.month(year, month)

@staticmethod
def is_month_end(dt: date) -> bool:
    """判断是否月末[4][5]
    Example: 2024-02-15 → False
    """
    return dt.day == calendar.monthrange(dt.year, dt.month)[1]

@staticmethod
def is_future_date(target: date) -> bool:
    """判断是否为未来日期[1]
    Example: 2025-01-01 → True
    """
    return target > date.today()

@staticmethod
def get_workdays(year: int, month: int) -> List[date]:
    """获取当月工作日列表[4][5]
    Example: 2024年2月 → 过滤周末的日期列表
    """
    return [date(year, month, day) for day in range(1, calendar.monthrange(year, month)[1]+1)
            if date(year, month, day).weekday() < 5]

@staticmethod
def get_week_number(dt: date) -> int:
    """获取ISO周数[2][3]
    Example: 2024-02-15 → 周数7
    """
    return dt.isocalendar()[1]

@staticmethod
def get_age(birth_date: date) -> int:
    """精确年龄计算[2][3]
    Example: 2000-03-15 → 24岁（当前日期2024-02-15）
    """
    today = date.today()
    return today.year - birth_date.year - ((today.month, today.day) < (birth_date.month, birth_date.day))

print("当前日期:", DateUtils.get_current_date())  # [1][3]
print("月末判断:", DateUtils.is_month_end(date(2024,2,28)))  # [4][5]
print("工作日列表:", DateUtils.get_workdays(2024, 2))  # [4][5]