These functions are accessible at

advtrains.lines.rwt.*

A railway time can be represented by 3 different formats: table, string or seconds. All API functions accept any of the formats as input, and usually output in table form, unless specified otherwise.

A railway time is represented in a table like this:

{
  s=45,
  m=23, 
  c=1,
}

A time string can be either in the form cc;mm;ss or mm;ss. Trailing 0's can be omitted. mm and ss must be within 0-60.

1:23:45

A simple integer value counting the seconds since 0;00;00.

5025

now()
Returns current railway time in table format

new(c, m, s)
Creates a new railway time in table format

copy(rwtime)
Explicitly creates a copy of rwtime, so that changes to either object don't affect the other

to_table(rwtime)
Explicitly converts to table format

to_secs(rwtime, [c_over])
Explicitly converts to seconds format.
c_over: if given, overrides the "cycle" value to this value before conversion, while not changing rwtime

to_string(rwtime_p, [no_cycle])
Explicitly converts to string format
no_cycle: if true, omits the cycle value, outputting a value of mm;ss

add(t1, t2)
Adds two railway times

diff(t1, t2)
Returns the time in seconds from t1 to t2 (=t2-t1)
Note the argument order: diff("00;15", "00;35") = 20

sub(t1, t2)
Subtracts t2 from t1, result is in table form.
The argument order is reverse to diff().

adjust_cycle(rwtime, reftime_p, thresh) adjust(rwtime, reftime, thresh)

adj_diff(t1, t2, thresh)

get_time_until(deptime, rwtime_p)

time_to_next_rpt(rwtime, rpt_interval, rpt_offset) time_from_last_rpt(rwtime, rpt_interval, rpt_offset) next_rpt(rwtime, rpt_interval, rpt_offset) local rwtime_s = rwt.to_secs(rwtime) local rpti_s = last_rpt(rwtime, rpt_interval, rpt_offset)