CosTime_TimeService(3)

💖 CosTime_TimeService — the Erlang module definition, bestie edition 💖

okay so real quick, this page lives in cosTime version 5.2.2 (it's an Erlang Module Definition, iykyk) and it's all about the CosTime::TimeService interface. let's get into it 🫶

---

✨ NAME ✨

CosTime_TimeService — this module implements the OMG CosTime::TimeService interface. that's the whole vibe. 💅

---

🌸 DESCRIPTION 🌸

sooo to actually get access to the record definitions for the structures (you're gonna want those, trust), use this:

-include_lib("cosTime/include/*.hrl").

that's it, that's the whole description. short and iconic. 🎀

---

👑 EXPORTS 👑

okay bestie, here's where the main character energy lives. four operations, all of them serving 💖

• universal_time(TimeService) -> Reply

Types:

TimeService = #objref
Reply = UTO | {'EXCEPTION", #'TimerService_TimeUnavailable'{}}
UTO = #objref

This operation returns the current time and the Inaccuracy given when starting this application in a UTO. The time base is 15 october 1582 00:00. Comparing two time objects which use different time base is, by obvious reasons, pointless. like literally don't even bother, it's giving chaos 🙈

---

• new_universal_time(TimeService, Time, Inaccuracy, Tdf) -> UTO

Types:

TimeService = UTO = #objref
Time = Inaccuracy = ulonglong()
Tdf = short()

This operation creates a new UTO object representing the time parameters given. This is the only way to create a UTO with an arbitrary time from its components. This is useful when using the Timer Event Service. no cap, this is the one 🔥

---

• uto_from_utc(TimeService, Utc) -> UTO

Types:

TimeService = UTO = #objref
Utc = #'TimeBase_UtcT'{time, inacclo, inacchi, tdf}
time = ulonglong()
inacclo = ulong()
inacchi = ushort()
tdf = short()

This operation is used to create a UTO given a time in the Utc form. you hand it the Utc, it hands you a UTO, everyone wins 🦋

---

• new_interval(TimeService, Lower, Upper) -> TIO

Types:

TimeService = TIO = #objref
Lower = Upper = ulonglong()

This operation is used to create a new TIO object, representing the input parameters.

⚠️ if Lower is greater than Upper, BAD_PARAM is raised. so like… don't do that bestie, the interval does not want that energy 💀

---

and that's the whole page!! 💜 this iconic little number was brought to you by Ericsson AB, part of cosTime 5.2.2 — go forth and timestamp responsibly, you absolute legend 👑✨🌸