MoonTime
MoonTime is a temporal system designed to translate human time into something older, quieter, and a little less linear.
It began with a simple problem:
If someone says “by the next moon”… how long is that, exactly?
MoonTime answers that by mapping any moment into a lunar-aware calendar, where phases, cycles, and celestial relationships shape the flow of time.
🌙 Features
-
🌗 Real-time lunar phase and illumination
-
🌌 Continuous lunar calendar (year, month, day)
-
🧭 Seasonal awareness
-
🕰️ Human-readable + machine-friendly formatting
-
🔁 Conversion from:
datetime- CLI input
-
🖥️ Command-line interface with planetary time modes
📦 Installation
pip install moontime
🚀 Quick Example
from moontime import MoonTime as mt
def example():
moon = mt.now() # Pull this moment
# Basic data on the moment:
print("Readout", moon)
print("Season:", moon.season)
print("Moon Phase:", moon.phase)
print("Moon illumination:", moon.illumination)
print("Moon angle:", moon.angle)
print("Lunar year:", moon.year)
print("Lunar month:", moon.month)
print("Lunar day:", moon.day)
print("Name of the month:", moon.lunar_month_name)
print("Day of the week:", moon.lunar_weekday)
# Functions:
if moon.is_day:
print("Is day:", "true")
else:
print("Is day:", "false")
print("strftime:", moon.strftime('%Y%m%d%H%M%S'))
if __name__ == "__main__":
example()
Example Output
Readout 6739-02-05 10:52:54.724282
Season: Spring
Moon Phase: First Quarter
Moon illumination: 42
Moon angle: 81.2754265988915
Lunar year: 6739
Lunar month: 2
Lunar day: 5
Name of the month: Umbra
Day of the week: Nycturia
Is day: false
strftime: 67390205105254
🧭 Core Concepts
MoonTime Object
moon = mt.now()
Represents a single moment translated into the MoonTime system.
Lunar Calendar
Each moment includes:
- Year → Continuous count (not tied to Gregorian)
- Month → Lunar cycle index
- Day → Position within the cycle
- Month Name → Symbolic naming (e.g. Umbra)
- Weekday → Custom lunar week system
Phase & Illumination
moon.phase
moon.illumination
- Phase: textual description (e.g. First Quarter)
- Illumination: percentage of visible moon
Angle
moon.angle
Angular relationship between the Moon and the Sun.
This is the underlying value that determines phase.
Day / Night
moon.is_day
Boolean indicating whether the sun is above the horizon.
Formatting
moon.strftime('%Y%m%d%H%M%S')
Works similarly to standard datetime.strftime, but uses MoonTime values.
⏳ Conversions
From datetime
from datetime import datetime, timezone
mt.from_datetime(datetime.now(timezone.utc))
Current Moment
mt.now()
🖥️ CLI Usage
MoonTime includes a command-line interface for quick queries.
Current Time
moontime now
6739-02-05 10:41:06.718833
Specific Date
moontime at 2025-05-12
6738-02-13 07:23:37.032349
moontime at 2025-05-01T12:34:56
6738-02-02 19:37:30.418148
Solar / Planetary Temporal Time Modes
moontime now --sun-time
dYO - 6739-02-05 10:41:51.168
moontime now --mars-time
Ma↓ 04:07:19
moontime now --planet-time moon
L↓ 04:55:46
These modes expose alternative time flows based on planetary cycles.
🧬 Design Philosophy
MoonTime is built to be:
- Continuous → No hard resets or calendar discontinuities
- Interoperable → Works alongside standard
datetime - Expressive → Carries meaning beyond raw timestamps
- Deterministic → Same input always yields the same moment
🌌 Ecosystem
MoonTime serves as the temporal foundation for:
aetherfield→ planetary positions and alignments- Other systems that require lunar-aware timing
🧪 Status
Early release. Core behavior is stable, but currently the data is extremely geocentric; allow an error margin of ~±12 hours..
🕯️ Closing Note
MoonTime does not replace standard time.
It runs alongside it.
A second clock — one that keeps track of cycles instead of seconds, and makes sense of promises like:
“by the next moon.”
Metadata
Release files for moontime 0.5.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| moontime-0.5.3.tar.gz | 24.3 kB | Without provenance | Details for moontime-0.5.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| moontime-0.5.3-py3-none-any.whl | Python 3 | none | any | Details for moontime-0.5.3-py3-none-any.whl |
Total release size: 47.0 kB
Release files / moontime-0.5.3.tar.gz
| Download URL | moontime-0.5.3.tar.gz |
|---|---|
| Size | 24.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dd4df4c3cbfdd111f05c36a86cec96f7f1fc6d2907d629c9c291e190304aa80d
|
|
BLAKE2b-256 checksum How to use checksums |
24ba8f3fe22968aba4a1ac3a42f857fec70047371c9f23a69b7598a84f67e6d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / moontime-0.5.3-py3-none-any.whl
| Download URL | moontime-0.5.3-py3-none-any.whl |
|---|---|
| Size | 22.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5b7edb46d5a786615a9b0623b522755e9b3b9aaf6ebd441a78b8a915a5f5a730
|
|
BLAKE2b-256 checksum How to use checksums |
e234fa7b505eba7749bf96f2360403e2f6ebd5bfad620197ce6ea3607bd15244
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Security for moontime 0.5.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.