GameDateTime

Contexte d’utilisation

Module	Package	Source SDK
Kotlin/Native	nimby	kotlin/src/nimby/GameDateTime.kt

API publique du SDK 0.9.0-alpha.2. Chaque entrée donne la signature Kotlin et son contrat : sens de la valeur, conditions d’utilisation et effets à connaître. Choisissez les imports du module indiqué ci-dessus.

Imports de cette page

import nimby.GameDateTime
import nimby.dateTime

nimby · class

data class GameDateTime(val year: Int, val month: Int, val day: Int,
                        val hour: Int = 0, val minute: Int = 0, val second: Int = 0)

Date et heure UTC du calendrier grégorien, à la seconde, validées à la construction. Les années vont de 1 à 9999 ; aucune normalisation d’une date invalide. Cette valeur seule ne change pas la partie.

GameDateTime.year

nimby · val

val year: Int

Année UTC de 1 à 9999. Le calcul des années bissextiles suit le calendrier grégorien.

GameDateTime.month

nimby · val

val month: Int

Mois UTC de 1 (janvier) à 12 (décembre).

GameDateTime.day

nimby · val

val day: Int

Jour du mois, à partir de 1 ; la limite dépend du mois et de l’année bissextile.

GameDateTime.hour

nimby · val

val hour: Int = 0

Heure UTC entre 0 et 23 ; zéro par défaut.

GameDateTime.minute

nimby · val

val minute: Int = 0

Minute entre 0 et 59 ; zéro par défaut.

GameDateTime.second

nimby · val

val second: Int = 0

Seconde entre 0 et 59 ; zéro par défaut. Les secondes intercalaires ne sont pas acceptées.

GameDateTime.toUtcSeconds

nimby · fun

fun toUtcSeconds(): Long

Convertit la date en secondes signées depuis le 1er janvier 1970 UTC. Les dates antérieures donnent une valeur négative ; aucun accès au jeu.

GameDateTime.toString

nimby · fun

override fun toString(): String

Formate la date sous la forme YYYY-MM-DDTHH:mm:ssZ, indépendamment de la langue et du fuseau horaire du PC.

GameDateTime.Companion.fromUtcSeconds

nimby · fun

fun fromUtcSeconds(seconds: Long): GameDateTime

Convertit des secondes UTC signées en date. Accepte de −62135596800 à 253402300799, bornes incluses ; refuse les valeurs hors des années 1 à 9999.

dateTime

nimby · fun

fun ToolClock.dateTime(): GameDateTime

Convertit utcSeconds de cette lecture en date UTC. Ne relit ni ne modifie l’horloge ; elapsedMillis ne participe pas à la conversion.