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)
| File | Size | Uploaded | |
|---|---|---|---|
| ticktock_utils-0.4.0.tar.gz | 8.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|