timediffz a library for timestamps and differences between dates

NOTE: timediffz ONLY work in almost any operating system(*1) which can support python 3.10 and above

*1: timediffz Tested on Arch Linux (Python 3.10+). The library is platform-independent and expected to work on Windows and macOS, but those environments are not yet officially tested.

timediffz is a library to make timestamps and calculating the differences between dates, uses exact rational arithmetic (fractions) instead of floating-point numbers, avoiding precision loss in date difference calculations. and nearly no for/while loops at all to provide fast performance literally you would need less than 100 microseconds in somecases to get the amount of months between the year 2025 and the end of the universe(year one googol), and it uses fractions based numbers to keep the numbers exact no floating point precision loss, and it has been made for scientists and systems as the most accurate system for its own job possible, note: in case of tropical year because of uncontrolled amount of parameters to count it to an unreliable level the J2000 is used but it's unreliable for extremely far dates but you can if you want to use new or other tropical dates via custom year parameter

THIS LIBRARY HAS TWO MODES THE TB1 MODE OR NORMAL ONE WHICH USES STANDARD LIBRARIES AND REQUESTS ONLY, BUT EVEN THOUGH IT'S FAST BUT YOU CAN USE THE SECOND MODE THAT IS EVEN FASTER WHICH IS THE TB2 BUT IT NEEDS ALL TB1'S REQUIREMENTS PLUS SETUPTOOLS AND CYTHON AND INSTALLING GMP ON YOUR COMPUTER AND BUILDING THE CYTHON SETUP FILE WITH THIS COMMAND:

cd (full path of folder where setupfractionals.py is in, found in the library files) & python setupfractionals.py build_ext --inplace

or the same but with python as python3:

cd (full path of folder where setupfractionals.py is in, found in the library files) & python3 setupfractionals.py build_ext --inplace

the first mode functions starts with prefix: p*, while second mode ones start with prefix: c*, then after the first prefix the second prefix is the function type if it was for timestamping it would be (p/c t*) or time diff. mode which would be (p/c d).

Install

to install use the following command(note installing the library in this way would install library requirements both main and optional):

pip install Timediffz

Contribute

if you have discovered a bug, or you want to change something just open a new issue at Issues

Contact

you can contact us using this email ,and you can be a part of our community by joining our discord server