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.3.1

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.3.1
File Size Uploaded
ticktock_utils-0.3.1.tar.gz 7.7 kB Details

Built distribution (wheel)

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

Total release size: 13.4 kB

Release files / ticktock_utils-0.3.1.tar.gz

Download URL ticktock_utils-0.3.1.tar.gz
Size 7.7 kB
Tags Source
SHA-256 checksum
How to use checksums
94c0b56fd1cb389a8d940cf0941876b65f48f3e24723f97299a357f4be65aeb2
BLAKE2b-256 checksum
How to use checksums
b9578dcb1994b6cdd643ee4c13716da1e960bec406e1d7c7bc6141facdb940a7
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.3.1-py3-none-any.whl

Download URL ticktock_utils-0.3.1-py3-none-any.whl
Size 5.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7b66255d19a48b566a58a2c0761f91601077c983e28f8f49ba20e64b71145899
BLAKE2b-256 checksum
How to use checksums
9c5d5360b0d3952a5e21f1082ed08c4dd24500b2341753fd4804d27413267239
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

0.4.0

2 release files

This release

0.3.1 This release

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