ticktock-utils 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,5 @@
1
+ # 默认忽略的文件
2
+ /shelf/
3
+ /workspace.xml
4
+ # 基于编辑器的 HTTP 客户端请求
5
+ /httpRequests/
@@ -0,0 +1,39 @@
1
+ <component name="InspectionProjectProfileManager">
2
+ <profile version="1.0">
3
+ <option name="myName" value="Project Default" />
4
+ <inspection_tool class="NonAsciiCharacters" enabled="false" level="WARNING" enabled_by_default="false" />
5
+ <inspection_tool class="PyDeprecationInspection" enabled="false" level="WARNING" enabled_by_default="false" />
6
+ <inspection_tool class="PyMethodOverridingInspection" enabled="false" level="WARNING" enabled_by_default="false" />
7
+ <inspection_tool class="PyPep8NamingInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
8
+ <option name="ignoredErrors">
9
+ <list>
10
+ <option value="N802" />
11
+ <option value="N806" />
12
+ </list>
13
+ </option>
14
+ </inspection_tool>
15
+ <inspection_tool class="PyShadowingBuiltinsInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
16
+ <option name="ignoredNames">
17
+ <list>
18
+ <option value="id" />
19
+ <option value="exit" />
20
+ </list>
21
+ </option>
22
+ </inspection_tool>
23
+ <inspection_tool class="PyShadowingNamesInspection" enabled="true" level="INFORMATION" enabled_by_default="true" />
24
+ <inspection_tool class="PySimplifyBooleanCheckInspection" enabled="false" level="WEAK WARNING" enabled_by_default="false" />
25
+ <inspection_tool class="PyStringConversionWithoutDunderMethodInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
26
+ <option name="ignoredTypes">
27
+ <list>
28
+ <option value="types.NoneType" />
29
+ </list>
30
+ </option>
31
+ </inspection_tool>
32
+ <inspection_tool class="PyUnreachableCodeInspection" enabled="false" level="WARNING" enabled_by_default="false" />
33
+ <inspection_tool class="SpellCheckingInspection" enabled="false" level="TYPO" enabled_by_default="false">
34
+ <option name="processCode" value="true" />
35
+ <option name="processLiterals" value="true" />
36
+ <option name="processComments" value="true" />
37
+ </inspection_tool>
38
+ </profile>
39
+ </component>
@@ -0,0 +1,6 @@
1
+ <component name="InspectionProjectProfileManager">
2
+ <settings>
3
+ <option name="USE_PROJECT_PROFILE" value="false" />
4
+ <version value="1.0" />
5
+ </settings>
6
+ </component>
@@ -0,0 +1,8 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <project version="4">
3
+ <component name="ProjectModuleManager">
4
+ <modules>
5
+ <module fileurl="file://$PROJECT_DIR$/.idea/ticktock.iml" filepath="$PROJECT_DIR$/.idea/ticktock.iml" />
6
+ </modules>
7
+ </component>
8
+ </project>
@@ -0,0 +1,10 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <module external.system.id="pyproject.toml" type="PYTHON_MODULE" version="4">
3
+ <component name="NewModuleRootManager">
4
+ <content url="file://$MODULE_DIR$">
5
+ <excludeFolder url="file://$MODULE_DIR$/.venv" />
6
+ </content>
7
+ <orderEntry type="jdk" jdkName="~\AppData\Local\Programs\Python\Python313\python.exe" jdkType="Python SDK" />
8
+ <orderEntry type="sourceFolder" forTests="false" />
9
+ </component>
10
+ </module>
@@ -0,0 +1,311 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <project version="4">
3
+ <component name="AutoImportSettings">
4
+ <option name="autoReloadType" value="SELECTIVE" />
5
+ </component>
6
+ <component name="ChangeListManager">
7
+ <list default="true" id="172d345c-f8a0-497f-a584-31b6b3875367" name="更改" comment="" />
8
+ <option name="SHOW_DIALOG" value="false" />
9
+ <option name="HIGHLIGHT_CONFLICTS" value="true" />
10
+ <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
11
+ <option name="LAST_RESOLUTION" value="IGNORE" />
12
+ </component>
13
+ <component name="FileTemplateManagerImpl">
14
+ <option name="RECENT_TEMPLATES">
15
+ <list>
16
+ <option value="Python Script" />
17
+ </list>
18
+ </option>
19
+ </component>
20
+ <component name="NextEditCompletionFeaturesState">
21
+ <decayedCancelled>
22
+ <entry key="MS100" value="1.0000964405898467" />
23
+ <entry key="MS500" value="1.1591618090475229" />
24
+ <entry key="S2" value="1.8845818799609633" />
25
+ <entry key="S5" value="2.800308991110335" />
26
+ <entry key="S10" value="3.983870653497609" />
27
+ <entry key="S30" value="6.600518362686354" />
28
+ <entry key="S60" value="8.181115530944503" />
29
+ <entry key="M2" value="9.36533502731586" />
30
+ <entry key="M5" value="10.289441194836623" />
31
+ <entry key="M10" value="11.028219955519832" />
32
+ <entry key="M15" value="12.337761033228663" />
33
+ <entry key="M30" value="17.795720758665453" />
34
+ <entry key="H1" value="25.888661738234475" />
35
+ <entry key="H2" value="33.12300824769356" />
36
+ <entry key="H4" value="38.005579952053026" />
37
+ <entry key="D1" value="42.91329021390861" />
38
+ <entry key="W1" value="43.84245842860452" />
39
+ </decayedCancelled>
40
+ <decayedSelected>
41
+ <entry key="MS100" value="0.0" />
42
+ <entry key="MS500" value="0.0" />
43
+ <entry key="S2" value="0.0" />
44
+ <entry key="S5" value="6.351345182661679E-155" />
45
+ <entry key="S10" value="7.98764923254065E-78" />
46
+ <entry key="S30" value="2.260194178612112E-26" />
47
+ <entry key="S60" value="1.926125254160628E-13" />
48
+ <entry key="M2" value="6.155500732237844E-7" />
49
+ <entry key="M5" value="0.007829128540238334" />
50
+ <entry key="M10" value="0.3032164390538688" />
51
+ <entry key="M15" value="1.1313425828350465" />
52
+ <entry key="M30" value="4.421031943679492" />
53
+ <entry key="H1" value="8.878351032541591" />
54
+ <entry key="H2" value="12.627195168560162" />
55
+ <entry key="H4" value="15.071915240216017" />
56
+ <entry key="D1" value="17.47451815042689" />
57
+ <entry key="W1" value="17.923957928910408" />
58
+ </decayedSelected>
59
+ <decayedShown>
60
+ <entry key="MS100" value="0.87063451970594" />
61
+ <entry key="MS500" value="1.127467403200326" />
62
+ <entry key="S2" value="1.8494382275522143" />
63
+ <entry key="S5" value="2.7089798830381144" />
64
+ <entry key="S10" value="3.8546294799157517" />
65
+ <entry key="S30" value="6.492223471135853" />
66
+ <entry key="S60" value="8.110904435168369" />
67
+ <entry key="M2" value="9.325192685347238" />
68
+ <entry key="M5" value="10.279801501280202" />
69
+ <entry key="M10" value="11.321605895791565" />
70
+ <entry key="M15" value="13.460853404742053" />
71
+ <entry key="M30" value="22.209249231435432" />
72
+ <entry key="H1" value="34.760934711760896" />
73
+ <entry key="H2" value="45.746174441239766" />
74
+ <entry key="H4" value="53.07515568733808" />
75
+ <entry key="D1" value="60.3873649649191" />
76
+ <entry key="W1" value="61.766351581961295" />
77
+ </decayedShown>
78
+ </component>
79
+ <component name="ProjectColorInfo">{
80
+ &quot;associatedIndex&quot;: 8,
81
+ &quot;fromUser&quot;: false
82
+ }</component>
83
+ <component name="ProjectId" id="3Ij7lnLhWfKKlOK2vhUoIFfVylD" />
84
+ <component name="ProjectViewState">
85
+ <option name="hideEmptyMiddlePackages" value="true" />
86
+ <option name="showLibraryContents" value="true" />
87
+ </component>
88
+ <component name="PropertiesComponent">{
89
+ &quot;keyToString&quot;: {
90
+ &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
91
+ &quot;Python.1.executor&quot;: &quot;Run&quot;,
92
+ &quot;Python.main.executor&quot;: &quot;Run&quot;,
93
+ &quot;Python.my_time (1).executor&quot;: &quot;Run&quot;,
94
+ &quot;Python.my_time.executor&quot;: &quot;Run&quot;,
95
+ &quot;Python.text.executor&quot;: &quot;Run&quot;,
96
+ &quot;Python.ticktock (1).executor&quot;: &quot;Run&quot;,
97
+ &quot;Python.实现.executor&quot;: &quot;Run&quot;,
98
+ &quot;Python.测试1.executor&quot;: &quot;Run&quot;,
99
+ &quot;Python.测试2.executor&quot;: &quot;Run&quot;,
100
+ &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
101
+ &quot;RunOnceActivity.typescript.service.memoryLimit.init&quot;: &quot;true&quot;,
102
+ &quot;codeWithMe.voiceChat.enabledByDefault&quot;: &quot;false&quot;,
103
+ &quot;last_opened_file_path&quot;: &quot;C:/Users/Administrator/Desktop/ticktock_project&quot;,
104
+ &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
105
+ &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
106
+ &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
107
+ &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
108
+ &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
109
+ &quot;settings.editor.selected.configurable&quot;: &quot;com.jetbrains.python.configuration.PyActiveSdkModuleConfigurable&quot;
110
+ }
111
+ }</component>
112
+ <component name="RunManager" selected="Python.ticktock (1)">
113
+ <configuration name="测试1" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
114
+ <module name="my_time" />
115
+ <option name="ENV_FILES" value="" />
116
+ <option name="INTERPRETER_OPTIONS" value="" />
117
+ <option name="PARENT_ENVS" value="true" />
118
+ <envs>
119
+ <env name="PYTHONUNBUFFERED" value="1" />
120
+ </envs>
121
+ <option name="SDK_HOME" value="" />
122
+ <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/My_Time" />
123
+ <option name="IS_MODULE_SDK" value="true" />
124
+ <option name="ADD_CONTENT_ROOTS" value="true" />
125
+ <option name="ADD_SOURCE_ROOTS" value="true" />
126
+ <option name="DEBUG_JUST_MY_CODE" value="false" />
127
+ <option name="RUN_TOOL" value="" />
128
+ <option name="SCRIPT_NAME" value="$PROJECT_DIR$/My_Time/测试1.py" />
129
+ <option name="PARAMETERS" value="" />
130
+ <option name="SHOW_COMMAND_LINE" value="false" />
131
+ <option name="EMULATE_TERMINAL" value="false" />
132
+ <option name="MODULE_MODE" value="false" />
133
+ <option name="REDIRECT_INPUT" value="false" />
134
+ <option name="INPUT_FILE" value="" />
135
+ <method v="2" />
136
+ </configuration>
137
+ <configuration name="测试1" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
138
+ <module name="ticktock" />
139
+ <option name="ENV_FILES" value="" />
140
+ <option name="INTERPRETER_OPTIONS" value="" />
141
+ <option name="PARENT_ENVS" value="true" />
142
+ <envs>
143
+ <env name="PYTHONUNBUFFERED" value="1" />
144
+ </envs>
145
+ <option name="SDK_HOME" value="" />
146
+ <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/ticktock" />
147
+ <option name="IS_MODULE_SDK" value="true" />
148
+ <option name="ADD_CONTENT_ROOTS" value="true" />
149
+ <option name="ADD_SOURCE_ROOTS" value="true" />
150
+ <option name="DEBUG_JUST_MY_CODE" value="false" />
151
+ <option name="RUN_TOOL" value="" />
152
+ <option name="SCRIPT_NAME" value="$PROJECT_DIR$/ticktock/测试1.py" />
153
+ <option name="PARAMETERS" value="" />
154
+ <option name="SHOW_COMMAND_LINE" value="false" />
155
+ <option name="EMULATE_TERMINAL" value="false" />
156
+ <option name="MODULE_MODE" value="false" />
157
+ <option name="REDIRECT_INPUT" value="false" />
158
+ <option name="INPUT_FILE" value="" />
159
+ <method v="2" />
160
+ </configuration>
161
+ <configuration name="测试2" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
162
+ <module name="ticktock" />
163
+ <option name="ENV_FILES" value="" />
164
+ <option name="INTERPRETER_OPTIONS" value="" />
165
+ <option name="PARENT_ENVS" value="true" />
166
+ <envs>
167
+ <env name="PYTHONUNBUFFERED" value="1" />
168
+ </envs>
169
+ <option name="SDK_HOME" value="" />
170
+ <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/ticktock" />
171
+ <option name="IS_MODULE_SDK" value="true" />
172
+ <option name="ADD_CONTENT_ROOTS" value="true" />
173
+ <option name="ADD_SOURCE_ROOTS" value="true" />
174
+ <option name="DEBUG_JUST_MY_CODE" value="false" />
175
+ <option name="RUN_TOOL" value="" />
176
+ <option name="SCRIPT_NAME" value="$PROJECT_DIR$/ticktock/测试2.py" />
177
+ <option name="PARAMETERS" value="" />
178
+ <option name="SHOW_COMMAND_LINE" value="false" />
179
+ <option name="EMULATE_TERMINAL" value="false" />
180
+ <option name="MODULE_MODE" value="false" />
181
+ <option name="REDIRECT_INPUT" value="false" />
182
+ <option name="INPUT_FILE" value="" />
183
+ <method v="2" />
184
+ </configuration>
185
+ <configuration name="main" type="PythonConfigurationType" factoryName="Python" nameIsGenerated="true">
186
+ <module name="ticktock" />
187
+ <option name="ENV_FILES" value="" />
188
+ <option name="INTERPRETER_OPTIONS" value="" />
189
+ <option name="PARENT_ENVS" value="true" />
190
+ <envs>
191
+ <env name="PYTHONUNBUFFERED" value="1" />
192
+ </envs>
193
+ <option name="SDK_HOME" value="" />
194
+ <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
195
+ <option name="IS_MODULE_SDK" value="true" />
196
+ <option name="ADD_CONTENT_ROOTS" value="true" />
197
+ <option name="ADD_SOURCE_ROOTS" value="true" />
198
+ <option name="DEBUG_JUST_MY_CODE" value="false" />
199
+ <option name="RUN_TOOL" value="" />
200
+ <option name="SCRIPT_NAME" value="$PROJECT_DIR$/main.py" />
201
+ <option name="PARAMETERS" value="" />
202
+ <option name="SHOW_COMMAND_LINE" value="false" />
203
+ <option name="EMULATE_TERMINAL" value="false" />
204
+ <option name="MODULE_MODE" value="false" />
205
+ <option name="REDIRECT_INPUT" value="false" />
206
+ <option name="INPUT_FILE" value="" />
207
+ <method v="2" />
208
+ </configuration>
209
+ <configuration name="text" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
210
+ <module name="ticktock" />
211
+ <option name="ENV_FILES" value="" />
212
+ <option name="INTERPRETER_OPTIONS" value="" />
213
+ <option name="PARENT_ENVS" value="true" />
214
+ <envs>
215
+ <env name="PYTHONUNBUFFERED" value="1" />
216
+ </envs>
217
+ <option name="SDK_HOME" value="" />
218
+ <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
219
+ <option name="IS_MODULE_SDK" value="true" />
220
+ <option name="ADD_CONTENT_ROOTS" value="true" />
221
+ <option name="ADD_SOURCE_ROOTS" value="true" />
222
+ <option name="DEBUG_JUST_MY_CODE" value="false" />
223
+ <option name="RUN_TOOL" value="" />
224
+ <option name="SCRIPT_NAME" value="$PROJECT_DIR$/text.py" />
225
+ <option name="PARAMETERS" value="" />
226
+ <option name="SHOW_COMMAND_LINE" value="false" />
227
+ <option name="EMULATE_TERMINAL" value="false" />
228
+ <option name="MODULE_MODE" value="false" />
229
+ <option name="REDIRECT_INPUT" value="false" />
230
+ <option name="INPUT_FILE" value="" />
231
+ <method v="2" />
232
+ </configuration>
233
+ <configuration name="ticktock (1)" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
234
+ <module name="ticktock" />
235
+ <option name="ENV_FILES" value="" />
236
+ <option name="INTERPRETER_OPTIONS" value="" />
237
+ <option name="PARENT_ENVS" value="true" />
238
+ <envs>
239
+ <env name="PYTHONUNBUFFERED" value="1" />
240
+ </envs>
241
+ <option name="SDK_HOME" value="" />
242
+ <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/ticktock" />
243
+ <option name="IS_MODULE_SDK" value="true" />
244
+ <option name="ADD_CONTENT_ROOTS" value="true" />
245
+ <option name="ADD_SOURCE_ROOTS" value="true" />
246
+ <option name="DEBUG_JUST_MY_CODE" value="false" />
247
+ <option name="RUN_TOOL" value="" />
248
+ <option name="SCRIPT_NAME" value="$PROJECT_DIR$/ticktock/ticktock.py" />
249
+ <option name="PARAMETERS" value="" />
250
+ <option name="SHOW_COMMAND_LINE" value="false" />
251
+ <option name="EMULATE_TERMINAL" value="false" />
252
+ <option name="MODULE_MODE" value="false" />
253
+ <option name="REDIRECT_INPUT" value="false" />
254
+ <option name="INPUT_FILE" value="" />
255
+ <method v="2" />
256
+ </configuration>
257
+ <configuration name="ticktock" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
258
+ <module name="ticktock" />
259
+ <option name="ENV_FILES" value="" />
260
+ <option name="INTERPRETER_OPTIONS" value="" />
261
+ <option name="PARENT_ENVS" value="true" />
262
+ <envs>
263
+ <env name="PYTHONUNBUFFERED" value="1" />
264
+ </envs>
265
+ <option name="SDK_HOME" value="" />
266
+ <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/My_Time" />
267
+ <option name="IS_MODULE_SDK" value="true" />
268
+ <option name="ADD_CONTENT_ROOTS" value="true" />
269
+ <option name="ADD_SOURCE_ROOTS" value="true" />
270
+ <option name="DEBUG_JUST_MY_CODE" value="false" />
271
+ <option name="RUN_TOOL" value="" />
272
+ <option name="SCRIPT_NAME" value="C:\Users\Administrator\Desktop\my_time_project\My_Time\ticktock.py" />
273
+ <option name="PARAMETERS" value="" />
274
+ <option name="SHOW_COMMAND_LINE" value="false" />
275
+ <option name="EMULATE_TERMINAL" value="false" />
276
+ <option name="MODULE_MODE" value="false" />
277
+ <option name="REDIRECT_INPUT" value="false" />
278
+ <option name="INPUT_FILE" value="" />
279
+ <method v="2" />
280
+ </configuration>
281
+ <recent_temporary>
282
+ <list>
283
+ <item itemvalue="Python.ticktock (1)" />
284
+ <item itemvalue="Python.测试2" />
285
+ <item itemvalue="Python.测试1" />
286
+ <item itemvalue="Python.ticktock" />
287
+ <item itemvalue="Python.text" />
288
+ </list>
289
+ </recent_temporary>
290
+ </component>
291
+ <component name="SharedIndexes">
292
+ <attachedChunks>
293
+ <set>
294
+ <option value="bundled-python-sdk-c6d794e1806d-5bd6d13a2a75-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-262.8665.309" />
295
+ </set>
296
+ </attachedChunks>
297
+ </component>
298
+ <component name="TaskManager">
299
+ <task active="true" id="Default" summary="默认任务">
300
+ <changelist id="172d345c-f8a0-497f-a584-31b6b3875367" name="更改" comment="" />
301
+ <created>1788266278559</created>
302
+ <option name="number" value="Default" />
303
+ <option name="presentableId" value="Default" />
304
+ <updated>1788266278559</updated>
305
+ </task>
306
+ <servers />
307
+ </component>
308
+ <component name="TypeScriptGeneratedFilesManager">
309
+ <option name="version" value="3" />
310
+ </component>
311
+ </project>
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 [李皓]
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,41 @@
1
+ Metadata-Version: 2.5
2
+ Name: ticktock_utils
3
+ Version: 0.1.0
4
+ Summary: 一个简单的时间处理工具库
5
+ Author-email: Your Name <you@example.com>
6
+ License-Expression: MIT
7
+ License-File: LICENSE
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Operating System :: OS Independent
10
+ Classifier: Programming Language :: Python :: 3
11
+ Requires-Python: >=3.8
12
+ Description-Content-Type: text/markdown
13
+
14
+ # my_time
15
+
16
+ 一个超级简单、轻量级的 Python 时间处理库。支持年月日、时分秒的获取,还自带贴心的**报错机制**!
17
+
18
+ ## 🚀 为什么要有它?
19
+
20
+ 因为 Python 自带的 `datetime` 模块对新手来说太庞大了,我专门做了这个库,让你用**最简单的方式**拿到时间,并且**不用担心输错数字**。
21
+
22
+ ## 📦 安装
23
+
24
+ ```bash
25
+ pip install my_time
26
+
27
+ ## Quick Start
28
+ import my_time
29
+
30
+ # 1. 拿到今天的年月日
31
+ year, month, day = my_time.get_ymd()
32
+ print(f"今天是 {year} 年 {month} 月 {day} 日")
33
+
34
+ # 2. 拿到当前的时分秒
35
+ hour, minute, second = my_time.get_hms()
36
+ print(f"现在是 {hour}:{minute}:{second}")
37
+
38
+ # 3. 拿到一个“完美”的日期字符串
39
+ date_str = my_time.format_date("%Y年%m月%d日")
40
+ print(date_str)
41
+
@@ -0,0 +1,28 @@
1
+ # my_time
2
+
3
+ 一个超级简单、轻量级的 Python 时间处理库。支持年月日、时分秒的获取,还自带贴心的**报错机制**!
4
+
5
+ ## 🚀 为什么要有它?
6
+
7
+ 因为 Python 自带的 `datetime` 模块对新手来说太庞大了,我专门做了这个库,让你用**最简单的方式**拿到时间,并且**不用担心输错数字**。
8
+
9
+ ## 📦 安装
10
+
11
+ ```bash
12
+ pip install my_time
13
+
14
+ ## Quick Start
15
+ import my_time
16
+
17
+ # 1. 拿到今天的年月日
18
+ year, month, day = my_time.get_ymd()
19
+ print(f"今天是 {year} 年 {month} 月 {day} 日")
20
+
21
+ # 2. 拿到当前的时分秒
22
+ hour, minute, second = my_time.get_hms()
23
+ print(f"现在是 {hour}:{minute}:{second}")
24
+
25
+ # 3. 拿到一个“完美”的日期字符串
26
+ date_str = my_time.format_date("%Y年%m月%d日")
27
+ print(date_str)
28
+
@@ -0,0 +1,26 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "ticktock_utils" # 你的包名,必须唯一!建议加个前缀,比如 "yourname-my-time"
7
+ version = "0.1.0" # 版本号,每次更新要递增
8
+ description = "一个简单的时间处理工具库" # 简单描述
9
+ readme = "README.md" # 你的说明文档
10
+ requires-python = ">=3.8" # 支持的 Python 版本
11
+ authors = [
12
+ {name = "Your Name", email = "you@example.com"}
13
+ ]
14
+ classifiers = [
15
+ "Programming Language :: Python :: 3",
16
+ "License :: OSI Approved :: MIT License",
17
+ "Operating System :: OS Independent",
18
+ ]
19
+
20
+ # 用这个声明许可证
21
+ license = "MIT"
22
+ # 指定许可证文件位置
23
+ license-files = ["LICENSE"]
24
+
25
+ [tool.hatch.build.targets.wheel]
26
+ packages = ["my_time"]
@@ -0,0 +1,37 @@
1
+ # tickock/__init__.py
2
+
3
+ from .ticktock import (
4
+ get_ymd,
5
+ get_hms,
6
+ get_now,
7
+ is_leap_year,
8
+ get_days_in_month,
9
+ format_date,
10
+ validate_date,
11
+ get_weekday,
12
+ is_weekend,
13
+ days_until_weekend,
14
+ secret_message,
15
+ TimeError,
16
+ MonthError,
17
+ DayError,
18
+ )
19
+
20
+ __all__ = [
21
+ "get_ymd",
22
+ "get_hms",
23
+ "get_now",
24
+ "is_leap_year",
25
+ "get_days_in_month",
26
+ "format_date",
27
+ "validate_date",
28
+ "get_weekday",
29
+ "is_weekend",
30
+ "days_until_weekend",
31
+ "secret_message",
32
+ "TimeError",
33
+ "MonthError",
34
+ "DayError",
35
+ ]
36
+
37
+ __version__ = "0.1.1"
@@ -0,0 +1,74 @@
1
+ # ticktock.py
2
+
3
+ import datetime
4
+
5
+ class TimeError(Exception):
6
+ """时间相关的自定义异常基类"""
7
+ pass
8
+
9
+ class MonthError(TimeError):
10
+ """月份输入错误(1-12以外)"""
11
+ pass
12
+
13
+
14
+ class DayError(TimeError):
15
+ """日期输入错误(超出当月天数)"""
16
+ pass
17
+
18
+ def get_ymd():
19
+ """获取当前的年月日,返回格式为 (年, 月, 日)"""
20
+ today = datetime.date.today()
21
+ return today.year, today.month, today.day
22
+
23
+ def get_hms():
24
+ """获取当前的时分秒,返回 (时, 分, 秒)"""
25
+ now = datetime.datetime.now()
26
+ return now.hour, now.minute, now.second
27
+
28
+ def get_now():
29
+ """获取完整的日期时间对象"""
30
+ return datetime.datetime.now()
31
+
32
+ def is_leap_year(year: int) -> bool:
33
+ """判断是否为闰年"""
34
+ return (year % 4 == 0 and year % 100 != 0) or (year % 400 == 0)
35
+
36
+ def get_days_in_month(year: int, month: int) -> int:
37
+ """返回某年某月有多少天"""
38
+ if month < 1 or month > 12:
39
+ raise MonthError(f"月份必须是 1~12,你输入了 {month}")
40
+ if month == 2:
41
+ return 29 if is_leap_year(year) else 28
42
+ if month in [4, 6, 9, 11]:
43
+ return 30
44
+ return 31
45
+ def format_date(fmt: str = "%Y-%m-%d"):
46
+ """返回当前日期的格式化字符串,默认 '2026-09-01'"""
47
+ return datetime.datetime.now().strftime(fmt)
48
+
49
+ def validate_date(year: int, month: int, day: int) -> bool:
50
+ if month < 1 or month > 12:
51
+ raise MonthError(f"月份必须是 1~12,你输入了 {month}")
52
+ max_day = get_days_in_month(year, month)
53
+ if day < 1 or day > max_day:
54
+ raise DayError(f"日期必须在 1~{max_day} 之间,你输入了 {day}")
55
+ return True
56
+ def get_weekday() -> int:
57
+ """返回今天是星期几(0=周一,6=周日)"""
58
+ return datetime.datetime.now().weekday()
59
+ def is_weekend() -> bool:
60
+ """判断今天是否为周末(周六或周日)"""
61
+ return get_weekday() >= 5
62
+ def days_until_weekend() -> int:
63
+ """计算距离下一个周末还有几天(如果是周末,返回0)"""
64
+ today = get_weekday()
65
+ days_to_saturday = (5 - today) % 7
66
+ return days_to_saturday
67
+ def secret_message():
68
+ """运行后,打印出作者留下的一句话(彩蛋)"""
69
+ print("【ticktock 作者留言】")
70
+ print("恭喜你发现了这个彩蛋!")
71
+ print("所有伟大的事情,都是从一行代码开始的。")
72
+ print("—— 来自一位小学生的程序员")
73
+ if __name__ == "__main__":
74
+ print("Hello World")
@@ -0,0 +1,7 @@
1
+ import ticktock
2
+
3
+ if __name__ == "__main__":
4
+ # 测试基础功能
5
+ print(f"今天是星期{ticktock.get_weekday() + 1}") # 因为返回的是0-6,所以要+1
6
+ print(f"今天是周末吗? {ticktock.is_weekend()}")
7
+ print(f"距离周末还有 {ticktock.days_until_weekend()} 天")
@@ -0,0 +1,4 @@
1
+ import ticktock
2
+
3
+ # 测试彩蛋
4
+ ticktock.secret_message()