Skip to main content

ticktock_utils

一个超级简单、轻量级的 Python 时间处理库。支持拿到当前时间、判断闰年、验证日期,还自带贴心报错!

🚀 快速开始(Quick Start)

安装很简单:

pip install ticktock_utils

然后你就可以用了:

import ticktock_utils

# 拿到今天
year, month, day = ticktock_utils.get_ymd()
print(f"今天是 {year}{month}{day} 日")

# 拿到现在
hour, minute, second = ticktock_utils.get_hms()
print(f"现在是 {hour}:{minute}:{second}")

🧠 功能列表

函数名 说明
get_ymd() 获取当前的年月日,返回 (年, 月, 日)
get_hms() 获取当前的时分秒,返回 (时, 分, 秒)
get_now() 获取完整的日期时间对象
is_leap_year(year) 判断某年是否为闰年
get_days_in_month(year, month) 判断某年某月有多少天
format_date(fmt) 任意格式输出当前日期
validate_date(year, month, day) 检查一个日期是否合法
get_weekday() 返回今天是星期几(0=周一,6=周日)
is_weekend() 判断今天是否为周末(周六或周日)
days_until_weekend() 计算距离下一个周末还有几天
secret_message() 打印作者的一句话(彩蛋)

## ⚠️ 报错处理

如果你输入了错误的月份或日期,**报错也不会让你头大**:

```python
import ticktock_utils

try:
    ticktock_utils.validate_date(2026, 2, 29)  # 2026年是平年,28天
except ticktock_utils.MonthError:
    print("月份输入有误!")
except ticktock_utils.DayError:
    print("日期超出当月天数了!")

📜 License

MIT

🎨 库变量

变量名 说明
error_is_english 控制报错语言(True=英文,False=中文)

🔧 示例:切换报错语言

import ticktock_utils

# 默认是中文报错
try:
    ticktock_utils.validate_date(2026, 13, 1)
except ticktock_utils.MonthError as e:
    print(e)  # 输出:月份必须是 1~12,你输入了 13

# 切换为英文报错
ticktock_utils.error_is_english = True
try:
    ticktock_utils.validate_date(2026, 13, 1)
except ticktock_utils.MonthError as e:
    print(e)  # 输出:Month must be 1~12, you input 13

Release files for ticktock-utils 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ticktock-utils 0.4.0
File Size Uploaded
ticktock_utils-0.4.0.tar.gz 8.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ticktock-utils 0.4.0
File Interpreter ABI Platform
ticktock_utils-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.0 kB

Release files / ticktock_utils-0.4.0.tar.gz

Download URL ticktock_utils-0.4.0.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f8767c359d82b5a2f7669fb5f5a2650d918e8695308b67003bd5d9bb2e8d70e9
BLAKE2b-256 checksum
How to use checksums
a9874977a143ce91dc796bf196e6ad164f678d866bab663a6e90fe024751ab64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / ticktock_utils-0.4.0-py3-none-any.whl

Download URL ticktock_utils-0.4.0-py3-none-any.whl
Size 6.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
89f14503143ca0b774f97bdda216ff4329909ce183426ea094c677f0551259a6
BLAKE2b-256 checksum
How to use checksums
1582cb87c43c54631e58b18b47d4eaa74064eba07c5270c08d873a1d719110fc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

0.8.0

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

This release

0.4.0 This release

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page