Time Modeling in Softanza using stzTimeLine

[Mansour Ayouni]

Hello All,

Most time-handling libraries across ecosystems (Python's datetime, Java's java.time, JavaScript's Luxon, etc.) treat time as scalar values to be parsed, formatted, or mathematically manipulated.

Softanza's stzTimeLine goes further: it treats time as a structured, visual, and semantic domain —  a workspace where events, periods, constraints, and analytics coexist in a single, self-describing object.

See it in action here in Ring NodePad:

And read about it for a complete guide of the feature, with many practical examples and ascii-based visualisations:

https://github.com/mayouni/stzlib/blob/main/libraries/stzlib/base/doc/narrations/stztimeline-managing-temporal-structures-narration.md

PS: stzTimeLine is a member iof the Time Programming module in Softanza containing also stzDate, stzTime, stzDateTime, and stzDuration classes.

All the best,

Mansour

[Bert Mariani]

Hello Mansour

You might be interested in Julian Dates: The Julian Date for the year 2001 is calculated based on the Julian calendar, which starts at noon on January 1, 4713 BCE. For the year 2001, the Julian Date (JD) is 2460708.75. This value represents the total number of days since the start of the Julian calendar, including any fractional parts that account for the time elapsed since the epoch. 

# =================================
# ---------- Time / Calendar ----------
func JulianDay(y,m,d)
    yy = y
    mm = m
    if mm <= 2
        yy = yy - 1
        mm = mm + 12
    end
    A = floor(yy/100)
    B = 2 - A + floor(A/4)
    jd = floor(365.25*(yy + 4716)) + floor(30.6001*(mm + 1)) + d + B - 1524.5
    return jd
end

# =================================

[Mansour Ayouni]

Hello Bert,

Thanks for catching that! It was the missing piece in the stzDate class (built on Qt’s QDate), and it’s now been added.

You can see all what stzDate does in this article:

https://github.com/mayouni/stzlib/blob/main/libraries/stzlib/base/doc/narrations/stzdate-date-programming-in-softanza.md

PS: stzDate is a member iof the Time Programming module in Softanza containing also stzTime, stzDateTime, stzDuration, and stzTimeLine classes. And I'm working to add a stzCalendar class to the team.

All the best,

Mansour

--

---
You received this message because you are subscribed to the Google Groups "The Ring Programming Language" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ring-lang+...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/ring-lang/84773e68-e0e7-49d0-b90e-3a38e4868e0bn%40googlegroups.com.