Skip to content

Commit c60b3f9

Browse files
danielonsecuritydanielonsecurity
committed
docs: Add tutorial on decimal daytime
1 parent fe013c9 commit c60b3f9

File tree

3 files changed

+217
-0
lines changed

3 files changed

+217
-0
lines changed

‎docs/images/clock.png‎

105 KB
Loading

‎docs/tutorials.rst‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,5 +12,8 @@ Contents:
1212
:maxdepth: 1
1313

1414
tutorials/setup_and_basic_usage
15+
tutorials/use_clock
1516
tutorials/managing_time_anchors
1617
tutorials/generating_timestamps_with_ai
18+
19+

‎docs/tutorials/use_clock.rst‎

Lines changed: 214 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,214 @@
1+
2+
3+
Show/use decimal clock
4+
=======================
5+
6+
.. _decimal_time_tutorial:
7+
8+
Decimal Time is an alternative system for measuring time that divides
9+
the day into a base-10 structure instead of the traditional 24-hour
10+
(duodecimal) system. This tutorial explains how to interpret decimal
11+
time and the advantages it offers for measuring and conceptualizing
12+
daytime.
13+
14+
Decimal Time System
15+
--------------------
16+
17+
In the decimal time system, the day is divided as follows:
18+
19+
**Decidays (D)**: 10 equal parts of the day (1 deciday = 8640 seconds).
20+
21+
**Centidays (C)**: 100 equal parts of a deciday (1 centiday = 864
22+
seconds).
23+
24+
**Seconds (SSS)**: The smallest unit, corresponding to regular seconds.
25+
26+
**Kiloseconds (KS)**: A larger unit representing 1000 seconds, used as an
27+
auxiliary representation.
28+
29+
A decimal time value is represented in two formats:
30+
31+
- D.C.SSS: Decidays, centidays, and seconds (e.g., 5.7.752).
32+
- Decimal float: A floating-point representation from 0.0000 to 10.0000 (e.g., 5.78704).
33+
34+
For comparison, traditional time is displayed in HH:MM:SS, while
35+
kiloseconds count up to 86.4 (as there are 86,400 seconds in a day).
36+
37+
Interpretation Examples
38+
-----------------------
39+
40+
The following table demonstrates how to interpret the time in
41+
different formats:
42+
43+
+------------------------+------------------+--------------------------+--------------------+
44+
| Decimal Time (D.C.SSS) | Decidays (float) | Standard Time (HH:MM:SS) | Kiloseconds (86.4) |
45+
+------------------------+------------------+--------------------------+--------------------+
46+
| 0.0.000 | 0.00000 | 00:00:00 | 0.00 |
47+
+------------------------+------------------+--------------------------+--------------------+
48+
| 0.4.144 | 0.41667 | 01:00:00 | 3.60 |
49+
+------------------------+------------------+--------------------------+--------------------+
50+
| 1.0.000 | 1.00000 | 02:24:00 | 8.64 |
51+
+------------------------+------------------+--------------------------+--------------------+
52+
| 1.5.000 | 1.50000 | 03:36:00 | 12.96 |
53+
+------------------------+------------------+--------------------------+--------------------+
54+
| 5.7.752 | 5.78704 | 13:53:20 | 50.00 |
55+
+------------------------+------------------+--------------------------+--------------------+
56+
| 8.3.288 | 8.33333 | 20:00:00 | 72.00 |
57+
+------------------------+------------------+--------------------------+--------------------+
58+
| 9.5.000 | 9.50000 | 22:48:00 | 82.08 |
59+
+------------------------+------------------+--------------------------+--------------------+
60+
| 10.0.000 | 10.00000 | 24:00:00 | 86.40 |
61+
+------------------------+------------------+--------------------------+--------------------+
62+
63+
Benefits of Decimal Time
64+
------------------------
65+
66+
Using a decimal-based time system offers several advantages:
67+
68+
- Simplified Arithmetic:
69+
70+
Decimal fractions make time calculations (e.g., elapsed time)
71+
simpler and more intuitive. Comparing and converting values is
72+
easier due to consistent base-10 scaling.
73+
74+
- Global Consistency:
75+
76+
A decimal system aligns better with metric units, fostering
77+
consistency across scientific and technical fields.
78+
79+
- Precision in Measurements:
80+
81+
The fractional representation (e.g., 0.41667 decidays) facilitates
82+
precise timekeeping, especially for engineering or computational
83+
purposes.
84+
85+
- Streamlined Conceptualization:
86+
87+
Conceptualizing a day as 10 units instead of 24 hours simplifies
88+
mental modeling of time intervals.
89+
90+
- Comparison with Duodecimal System
91+
92+
The traditional 24-hour (duodecimal) system divides the day into
93+
uneven divisions (24 hours, 60 minutes per hour, 60 seconds per
94+
minute). While familiar, it complicates calculations and is not
95+
compatible with the base-10 metric standard. Decimal time eliminates
96+
these irregularities.
97+
98+
Use Cases
99+
----------
100+
101+
Decimal time is particularly useful in:
102+
103+
**Scientific research**: Where precise time measurement and calculations
104+
are critical.
105+
106+
**Education**: Helping students better understand time as a quantitative
107+
concept.
108+
109+
**Software development**: Simplifying time-related computations in
110+
applications and simulations.
111+
112+
Decimal time in UTMS
113+
---------------------
114+
115+
To show the conversion table in UTMS with all those formats, use the
116+
`utms daytime` command (shortcut for `utms daytime timetable`):
117+
118+
.. code-block:: console
119+
120+
$ utms daytime
121+
+------------------------+------------------+--------------------------+--------------------+
122+
| Decimal Time (D.C.SSS) | Decidays (float) | Standard Time (HH:MM:SS) | Kiloseconds (86.4) |
123+
+------------------------+------------------+--------------------------+--------------------+
124+
| 0.0.000 | 0.00000 | 00:00:00 | 0.00 |
125+
| 0.4.144 | 0.41667 | 01:00:00 | 3.60 |
126+
| 0.5.000 | 0.50000 | 01:12:00 | 4.32 |
127+
| 0.8.288 | 0.83333 | 02:00:00 | 7.20 |
128+
| 1.0.000 | 1.00000 | 02:24:00 | 8.64 |
129+
| 1.1.496 | 1.15741 | 02:46:40 | 10.00 |
130+
| 1.2.432 | 1.25000 | 03:00:00 | 10.80 |
131+
| 1.5.000 | 1.50000 | 03:36:00 | 12.96 |
132+
| 1.6.576 | 1.66667 | 04:00:00 | 14.40 |
133+
| 2.0.000 | 2.00000 | 04:48:00 | 17.28 |
134+
| 2.0.720 | 2.08333 | 05:00:00 | 18.00 |
135+
| 2.3.128 | 2.31481 | 05:33:20 | 20.00 |
136+
| 2.5.000 | 2.50000 | 06:00:00 | 21.60 |
137+
| 2.9.144 | 2.91667 | 07:00:00 | 25.20 |
138+
| 3.0.000 | 3.00000 | 07:12:00 | 25.92 |
139+
| 3.3.288 | 3.33333 | 08:00:00 | 28.80 |
140+
| 3.4.624 | 3.47222 | 08:20:00 | 30.00 |
141+
| 3.5.000 | 3.50000 | 08:24:00 | 30.24 |
142+
| 3.7.432 | 3.75000 | 09:00:00 | 32.40 |
143+
| 4.0.000 | 4.00000 | 09:36:00 | 34.56 |
144+
| 4.1.576 | 4.16667 | 10:00:00 | 36.00 |
145+
| 4.5.000 | 4.50000 | 10:48:00 | 38.88 |
146+
| 4.5.720 | 4.58333 | 11:00:00 | 39.60 |
147+
| 4.6.256 | 4.62963 | 11:06:40 | 40.00 |
148+
| 5.0.000 | 5.00000 | 12:00:00 | 43.20 |
149+
| 5.4.144 | 5.41667 | 13:00:00 | 46.80 |
150+
| 5.5.000 | 5.50000 | 13:12:00 | 47.52 |
151+
| 5.7.752 | 5.78704 | 13:53:20 | 50.00 |
152+
| 5.8.288 | 5.83333 | 14:00:00 | 50.40 |
153+
| 6.0.000 | 6.00000 | 14:24:00 | 51.84 |
154+
| 6.2.432 | 6.25000 | 15:00:00 | 54.00 |
155+
| 6.5.000 | 6.50000 | 15:36:00 | 56.16 |
156+
| 6.6.576 | 6.66667 | 16:00:00 | 57.60 |
157+
| 6.9.384 | 6.94444 | 16:40:00 | 60.00 |
158+
| 7.0.000 | 7.00000 | 16:48:00 | 60.48 |
159+
| 7.0.720 | 7.08333 | 17:00:00 | 61.20 |
160+
| 7.5.000 | 7.50000 | 18:00:00 | 64.80 |
161+
| 7.9.144 | 7.91667 | 19:00:00 | 68.40 |
162+
| 8.0.000 | 8.00000 | 19:12:00 | 69.12 |
163+
| 8.1.016 | 8.10185 | 19:26:40 | 70.00 |
164+
| 8.3.288 | 8.33333 | 20:00:00 | 72.00 |
165+
| 8.5.000 | 8.50000 | 20:24:00 | 73.44 |
166+
| 8.7.432 | 8.75000 | 21:00:00 | 75.60 |
167+
| 9.0.000 | 9.00000 | 21:36:00 | 77.76 |
168+
| 9.1.576 | 9.16667 | 22:00:00 | 79.20 |
169+
| 9.2.512 | 9.25926 | 22:13:20 | 80.00 |
170+
| 9.5.000 | 9.50000 | 22:48:00 | 82.08 |
171+
| 9.5.720 | 9.58333 | 23:00:00 | 82.80 |
172+
+------------------------+------------------+--------------------------+--------------------+
173+
174+
175+
To convert between D.C.SSS and HH:MM:SS formats, use the `utms daytime convert` command:
176+
177+
.. code-block:: console
178+
179+
$ utms daytime convert 5.8.288
180+
14:00:00
181+
182+
$ utms daytime convert 2.8
183+
06:43:12
184+
185+
$ utms daytime convert 13:05
186+
5.4.443
187+
188+
$ utms daytime convert 22:05:47
189+
9.2.059
190+
191+
And if you want to show analog clocks with all those units in one
192+
place, use the `utms clock` command. It will open a window with 2
193+
clocks in both decimal and duodecimal systems, and show all units in
194+
it:
195+
196+
.. code-block:: console
197+
198+
$ utms clock
199+
200+
201+
.. image:: ../images/clock.png
202+
203+
204+
205+
206+
Conclusion
207+
-----------
208+
209+
The decimal time system is an efficient, intuitive, and precise method
210+
of measuring and representing time. While its adoption may require
211+
initial adjustments, its advantages make it a powerful alternative to
212+
the traditional 24-hour system. By understanding and utilizing decimal
213+
time, users can streamline calculations, enhance precision, and align
214+
with the metric standard.

0 commit comments

Comments
 (0)