NRF Guide

Lire et agir

Horloge de simulation

Lire le temps du jeu et changer sa date depuis un outil Kotlin.

Lire une date UTC

kotlin
val snapshot = client.capture()
val date = snapshot.clock?.toInstant()
println(date ?: "Horloge indisponible")

SimulationClock contient epochSeconds et ticks. Un tick représente un centième de seconde. toInstant combine les deux et accepte une époque antérieure à 1970 ; des ticks négatifs sont rejetés.

Modifier explicitement le calendrier

kotlin
val result = client.setSimulationDateTime(
    java.time.Instant.parse("2026-09-27T12:00:00Z"),
    recalculateTrains = false
)
println(result.clock.toInstant())

L’entrée doit être en secondes UTC entières, sans nanosecondes. Le runtime préserve la phase sous-seconde native. recalculateTrains demande en plus le recalcul natif des trains ; interventions indique son résultat compté.