ManiaScript Trackmania 2020  14/07/2025
TimeLib Namespace Reference

Standard time manipulation functions. More...

Enumerations

enum  EDateFormats {
  Full, Date, DateCompact, DateShort,
  Time, TimeShort, Relative, RelativeShort,
  MonthYear
}
 
enum  EDurationFormats { Full, Abbreviated, Chrono }
 

Functions

Text FormatDate (Text _Timestamp, EDateFormats _Format)
 Returns the date corresponding to a timestamp, formatted according to the locale. Not available on servers. More...
 
Text FormatDelta (Text _Timestamp1, Text _Timestamp2, EDurationFormats _Format)
 Returns the duration between 2 timestamps, formatted according to the locale. Not available on servers. More...
 
Text FormatDelta (Text _Delta, EDurationFormats _Format)
 Returns the duration Delta formatted according to the locale. Not available on servers. More...
 
Integer Compare (Text _Timestamp1, Text _Timestamp2)
 Compares 2 timestamps. More...
 
Real Clamp01 (Text _Boundary1, Text _Boundary2, Text _Timestamp)
 Returns a Real between 0 and 1, given an interval and a timestamp. More...
 
Real Clamp01TZDay (Text _Timestamp)
 Returns a Real between 0 and 1, given a timestamp, according to the day cycle in local timezone. More...
 
Real Clamp01UTCDay (Text _Timestamp)
 Returns a Real between 0 and 1, given a timestamp, according to the day cycle in UTC timezone. More...
 
Text GetCurrent ()
 Gets current timestamp. More...
 
Integer GetDelta (Text _Timestamp1, Text _Timestamp2)
 Returns the duration in seconds between 2 timestamps. May be clamped if huge. More...
 
Integer GetLocalDelta_Years (Text _Timestamp1, Text _Timestamp2)
 Returns the duration in complete years between 2 timestamps, according to the local dates. More...
 
Integer GetLocalDelta_Months (Text _Timestamp1, Text _Timestamp2)
 Returns the duration in complete months between 2 timestamps, according to the local dates. More...
 
Integer GetMillisecondsSinceInit ()
 Returns local milliseconds elapsed since game initialisation. More...
 

Detailed Description

Standard time manipulation functions.

Enumeration Type Documentation

◆ EDateFormats

Enumerator
Full 
Date 
DateCompact 
DateShort 
Time 
TimeShort 
Relative 
RelativeShort 
MonthYear 

Definition at line 22390 of file 2025_07_14.h.

22390  {
22391  Full,
22392  Date,
22393  DateCompact,
22394  DateShort,
22395  Time,
22396  TimeShort,
22397  Relative,
22398  RelativeShort,
22399  MonthYear,
22400  };

◆ EDurationFormats

Enumerator
Full 
Abbreviated 
Chrono 

Definition at line 22404 of file 2025_07_14.h.

22404  {
22405  Full,
22406  Abbreviated,
22407  Chrono,
22408  };

Function Documentation

◆ Clamp01()

Real TimeLib::Clamp01 ( Text  _Boundary1,
Text  _Boundary2,
Text  _Timestamp 
)

Returns a Real between 0 and 1, given an interval and a timestamp.

Parameters
_Boundary1: Lower boundary defining the time interval
_Boundary2: Higher boundary defining the time interval
_Timestamp: Timestamp to check

◆ Clamp01TZDay()

Real TimeLib::Clamp01TZDay ( Text  _Timestamp)

Returns a Real between 0 and 1, given a timestamp, according to the day cycle in local timezone.

Parameters
_Timestamp: Timestamp to check

◆ Clamp01UTCDay()

Real TimeLib::Clamp01UTCDay ( Text  _Timestamp)

Returns a Real between 0 and 1, given a timestamp, according to the day cycle in UTC timezone.

Parameters
_Timestamp: Timestamp to check

◆ Compare()

Integer TimeLib::Compare ( Text  _Timestamp1,
Text  _Timestamp2 
)

Compares 2 timestamps.

Parameters
_Timestamp1: Unix timestamp
_Timestamp2: Unix timestamp

◆ FormatDate()

Text TimeLib::FormatDate ( Text  _Timestamp,
EDateFormats  _Format 
)

Returns the date corresponding to a timestamp, formatted according to the locale. Not available on servers.

Parameters
_Timestamp: Timestamp to format
_Format: Format

◆ FormatDelta() [1/2]

Text TimeLib::FormatDelta ( Text  _Delta,
EDurationFormats  _Format 
)

Returns the duration Delta formatted according to the locale. Not available on servers.

Parameters
_Delta: Delta in seconds
_Format: Format

◆ FormatDelta() [2/2]

Text TimeLib::FormatDelta ( Text  _Timestamp1,
Text  _Timestamp2,
EDurationFormats  _Format 
)

Returns the duration between 2 timestamps, formatted according to the locale. Not available on servers.

Parameters
_Timestamp1: Timestamp1
_Timestamp2: Timestamp2
_Format: Format

◆ GetCurrent()

Text TimeLib::GetCurrent ( )

Gets current timestamp.

◆ GetDelta()

Integer TimeLib::GetDelta ( Text  _Timestamp1,
Text  _Timestamp2 
)

Returns the duration in seconds between 2 timestamps. May be clamped if huge.

Parameters
_Timestamp1: First timestamp. Result will be positive if this one is bigger/more recent
_Timestamp2: Second timestamp

◆ GetLocalDelta_Months()

Integer TimeLib::GetLocalDelta_Months ( Text  _Timestamp1,
Text  _Timestamp2 
)

Returns the duration in complete months between 2 timestamps, according to the local dates.

Parameters
_Timestamp1: First timestamp. Result will be positive if this one is bigger/more recent
_Timestamp2: Second timestamp

◆ GetLocalDelta_Years()

Integer TimeLib::GetLocalDelta_Years ( Text  _Timestamp1,
Text  _Timestamp2 
)

Returns the duration in complete years between 2 timestamps, according to the local dates.

Parameters
_Timestamp1: First timestamp. Result will be positive if this one is bigger/more recent
_Timestamp2: Second timestamp

◆ GetMillisecondsSinceInit()

Integer TimeLib::GetMillisecondsSinceInit ( )

Returns local milliseconds elapsed since game initialisation.

TimeLib::RelativeShort
@ RelativeShort
Definition: 2025_07_14.h:22398
TimeLib::Abbreviated
@ Abbreviated
Definition: 2025_07_14.h:22406
TimeLib::Full
@ Full
Definition: 2025_07_14.h:22391
TimeLib::DateShort
@ DateShort
Definition: 2025_07_14.h:22394
TimeLib::DateCompact
@ DateCompact
Definition: 2025_07_14.h:22393
TimeLib::MonthYear
@ MonthYear
Definition: 2025_07_14.h:22399
TimeLib::Date
@ Date
Definition: 2025_07_14.h:22392
TimeLib::TimeShort
@ TimeShort
Definition: 2025_07_14.h:22396
TimeLib::Chrono
@ Chrono
Definition: 2025_07_14.h:22407
TimeLib::Time
@ Time
Definition: 2025_07_14.h:22395
TimeLib::Relative
@ Relative
Definition: 2025_07_14.h:22397