util

Quelle: base/tealdef/scripts/util.d.tl

Hinweise

Typen von /scripts/util.tl (Util): löst Verweise auf Skriptfunktionen auf und formatiert Zeitdauern in Spielzeit. Du lädst es mit local util = ug_require "/scripts/util.tl" as Util.

Util

record global base/tealdef/scripts/util.d.tl:3

global record Util

Laden: local util = ug_require "::/scripts/util.tl" as Util

Hinweise

Verschiedene Skript-Helfer, die ug_require "/scripts/util.tl" zurückgibt.

Funktionen

teal only extension of util --> call with util.funYouWannaCall(...) and util = ug_require "path/to/this"

useFn(string) : function base/tealdef/scripts/util.d.tl:5

Aufruf: util.useFn(…)

Die Spieldateien enthalten hierzu noch keine Beschreibung.

Rückgabe function

Im Basisspiel verwendet: 70-mal in 29 Dateien

base/content/game_mechanics/game_mechanics/notifications/gui/notification_log.tl:31

local dataStateFn = util.useFn(param.entry.notification.type .. "@useDataState") as (function(any, any) : NotificationGuiData)

base/content/game_mechanics/game_mechanics/notifications/gui/notification_popups.tl:62

local dataStateFn = util.useFn(params.notification.type .. "@useDataState") as (function(any, any) : NotificationGuiData)

base/content/game_mechanics/game_mechanics/notifications/notification_legacy_util.tl:71

local scriptGetNotificationData = util.useFn(subventionDesc.scriptFile) as SubventionScript<any>

base/content/game_mechanics/game_mechanics/notifications/notification_util.tl:152

local dataStateFn = util.useFn(updateScript) as (function(any, any) : any)

base/content/game_mechanics/game_mechanics/notifications/notifications.script.tl:76

local dataStateFn = util.useFn(updateScript) as (function(any, any) : any)

base/content/game_mechanics/game_mechanics/notifications/types/notification_react_util.tl:122

local dataStateFn = util.useFn(params.notification.type .. "@useDataState") as (function(any, any) : NotificationGuiData)

… und 23 weitere Dateien.

formatTimePoint(number) : string base/tealdef/scripts/util.d.tl:6

Aufruf: util.formatTimePoint(…)

Die Spieldateien enthalten hierzu noch keine Beschreibung.

Rückgabe string

formatDurationWithCurrentCalenderSpeed(durationInDefaultSpeedMs : integer, integer, ?DurationRounding) : string base/tealdef/scripts/util.d.tl:13

Aufruf: util.formatDurationWithCurrentCalenderSpeed(…)

Hinweise

Formatiert eine Dauer bei der aktuellen Kalendergeschwindigkeit als Jahre, Monate und Tage.

Parameter	Typ	Beschreibung
durationInDefaultSpeedMs	integer	Dauer in Millisekunden Spielzeit.
#2	integer	Das aktuelle millisPerDay der Komponente GAME_SPEED. Bei 0 (Kalender angehalten) wird stattdessen die reine Spielzeit formatiert.
#3	?DurationRounding	Optionaler Rundungsmodus. Ohne ihn nennt das Ergebnis Jahre, Monate und Tage.

Rückgabe string: Übersetzter Text wie „1 Jahr 3 Monate“.

Im Basisspiel verwendet: 27-mal in 13 Dateien

base/content/game_mechanics/game_mechanics/company/company_util.tl:216

remainingTime = util.formatDurationWithCurrentCalenderSpeed(math_util.round(remainingCooldown.remainingMs), millisPerDay)

base/content/game_mechanics/game_mechanics/finance/finances_cargo_lifetime.tl:70

text = labelInMilliSeconds == 0 and lang_util.formatInt(0) or util.formatDurationWithCurrentCalenderSpeed(labelInMilliSeconds, millisPerDayState:old(), "Month")

base/content/game_mechanics/game_mechanics/finance/finances_loan_gui.tl:45

return util.formatDurationWithCurrentCalenderSpeed(formatMe, millisPerDayState:old(), "OnlyMonth")

base/content/game_mechanics/game_mechanics/notifications/types/notification_react_util.tl:43

remainingTime = util.formatDurationWithCurrentCalenderSpeed(math_util.round(params.progress.remainingDurationMs), millisPerDayState:old())

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo/deliver_cargo.script.tl:337

local duration = util.formatDurationWithCurrentCalenderSpeed(data.effectDuration, millisPerDay)

base/content/game_mechanics/game_mechanics/subventions/deliver_cargo_town/deliver_cargo_town.script.tl:433

local duration = util.formatDurationWithCurrentCalenderSpeed(data.effectDuration as integer, millisPerDay)

… und 7 weitere Dateien.

Util.DurationRounding

enum base/tealdef/scripts/util.d.tl:8

enum DurationRounding

Hinweise

Rundungsmodus für formatDurationWithCurrentCalenderSpeed.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/scripts/scripts/util.tl:40

function util.formatDurationWithCurrentCalenderSpeed(durationInDefaultSpeed : integer, currentMillisPerDay : integer, rounding? : Util.DurationRounding) : strin

Wert	Beschreibung
"OnlyMonth"	Zeigt die Dauer nur in Monaten (Jahre werden in Monate umgerechnet).
"Month"	Zeigt Jahre und Monate, auf den nächsten Monat gerundet.
"Year"	Zeigt ganze Jahre, auf das nächste Jahr gerundet.