Imperial Dating System¶
Usage¶
After praying to Machine-God Omnisiah, then command this Lingua-technis to your Cogitator.
>>> from imperial_dateutil import ImperialDatingSystem
>>> from datetime import datetime, timedelta
>>> d_t = ImperialDatingSystem(0, 123, 456, 41)
<check_digit=0, year_fraction=123, year=456, millennium=M41>
>>> print(d_t)
0123456.M41
>>> print(ImperialDatingSystem(0, 123, 456, 41) + ImperialDatingSystem(0, 123, 456, 41))
0246912.M82
>>> print(ImperialDatingSystem(0, 123, 456, 41) + timedelta(days=9000))
0780480.M41
>>> print(timedelta(hours=8.8) + ImperialDatingSystem(0, 123, 456, 41))
0124456.M41
>>> print(ImperialDatingSystem.now())
0995019.M3
>>> ImperialDatingSystem(0 ,123, 456, 41) == ImperialDatingSystem(0, 123, 456, 41)
True
>>> ImperialDatingSystem(0 ,123, 457, 41) > ImperialDatingSystem(0, 123, 456, 41)
True
>>> print(ImperialDatingSystem.from_gregorian(datetime(2005, 7, 18, 16)))
0549005.M3
API¶
-
class
imperial_dateutil.core.imperial.
ImperialDatingSystem
(check_number, year_fraction, year, millennium)[source]¶ Bases:
object
The Imperial Dating System of the Imperium of Man, also known as the Imperial Calendar, is fairly complex in nature, and has been structured so as to deal with the vast amount of recorded history that exists in the 41st Millenium and the massive distances between settled human worlds, which can lead to long periods of isolation.
Also the vagaries and time-warping effects of the Immaterium can make it almost impossible to keep accurate track of time over long journeys.
The Imperium has developed its own method of recording dates, which needs a bit of explanation. Most importantly, the years are always Anno Domini (A.D.) using the numbering system of our own present-day Gregorian Calendar, so the dates themselves are the ones that we are familiar with now.
A typical date as Imperial scholars write it would look something like 0.123.456.M41. This date can be divided up so that each part is explained separately below:
Check Number
Year Fraction
Year
Millennium
0
123
456
M41
Following the birth of the Great Rift and the start of the Era Indomitus, temporal anomalies spread across the galaxy making the use of a universal dating system extremely difficult as different Imperial worlds began to experience the passage of time at different subjective rates.
A new, more localised dating system came into existence that was different for each world. It used the birth of the Great Rift as the standard event from which all time was calculated, either before or after its creation.
- Copyright
this descriptions are copied from https://warhammer40k.fandom.com/wiki/Imperial_Dating_System
- Parameters
check_number (int) – The check number refers to the accuracy of a given date, which is required for clarity due to the common distortions of subjective linear time that occur while travelling within the Warp, and inaccuracies in timing on remote or isolated Imperial worlds and star systems.
year_fraction (int) – For record-keeping, each year is divided into 1000 equal parts, numbered 001-000, rather than months or weeks. Note that this system is not generally used by Imperial citizens in everyday life, but is simply for administrative use by the Adeptus Terra.
year (int) – This is the year within the millennium, running from 001-999.
millennium (int) – This is the millennium since the birth of the ancient human religious figure Jesus Christ in which the event took place.
-
classmethod
from_gregorian
(t, check_number=0)[source]¶ A function returns ImperialDatingSystem of given gregorian date/datetime
- Parameters
t (datetime.datetime or datetime.date) – Gregorian based datetime or date
check_number – accuracy of t, numbered 0-9
- Returns
Imperial time format of given t