kotlinx.datetime en français

Simon Moisselin -

Introduction à kotlinx.datetime

La bibliothèque kotlinx.datetime est spécialement conçue pour assister les développeurs Kotlin dans la gestion des valeurs associées aux dates et heures. Son objectif principal est de simplifier l'expérience utilisateur, proposant ainsi une API épurée. Si vous cherchez à intégrer cette bibliothèque dans votre projet Kotlin, des indications détaillées sont disponibles sur son dépôt GitHub.

Caractéristiques de kotlinx.datetime

Cette bibliothèque s'appuie sur la norme ISO 8601 pour définir les représentations des dates et heures, sans offrir d'autres formats. Il est important de noter qu'elle ne propose pas de fonctionnalités d'internationalisation, ce qui signifie qu'elle ne peut pas retourner des noms de mois ou de jours adaptés à différentes localisations.

Voici quelques-unes des fonctionnalités clés de la bibliothèque : - asTimeZone() : Convertit un objet UtcOffset en un fuseau horaire avec un décalage fixe.

  • atDate() : Combine une date avec une heure pour créer un objet LocalDateTime.
  • atStartOfDayIn() : Renvoie un instant correspondant au début d'une date dans un fuseau horaire spécifique.
  • atTime() : Fusionne une date et une heure, résultant en un objet LocalDateTime.
  • DateTimePeriod() : Retourne un objet DateTimePeriod indiquant la différence temporelle entre deux dates.
  • daysUntil() : Renvoie le nombre de jours entre deux instants.
  • minus() : Calcule la différence entre deux dates, ou entre une date et une unité temporelle.
  • monthsUntil() : Retourne le nombre de mois entre deux dates.
  • offsetAt() : Trouve le décalage par rapport à l'UTC que ce fuseau horaire présente à un instant donné.
  • offsetIn() : Donne le décalage horaire à un moment précis.
  • periodUntil() : Retourne un objet représentant la différence entre deux dates.
  • plus() : Ajoute un objet datetime à une période datetime spécifiée.
  • toDatePeriod() : Analyse la représentation de durée ISO-8601 en tant qu'objet DatePeriod.
  • toDateTimePeriod() : Interprète une chaîne de durée formatée en ISO-8601, la transformant en un objet DateTimePeriod.
  • todayIn() : Renvoie une date pour la valeur Clock donnée et le fuseau horaire spécifié.
  • toInstant() : Convertit une chaîne représentant un instant au format ISO-8601, qui inclut à la fois la date et l'heure avec le décalage de fuseau horaire, en une valeur Instant.

Utilisation concrète de kotlinx.datetime

L'intégration de la bibliothèque kotlinx.datetime peut être un atout majeur pour quiconque développe un site web ou une startup dont les fonctionnalités impliquent des manipulations temporelles. Par exemple, si vous souhaitez gérer la date et l'heure des réservations sur un site de billetterie, vous pouvez utiliser atDate() et minus() pour calculer les délais.

Voici comment commencer :

import kotlinx.datetime.*

fun main() {
    // Crée un objet LocalDateTime pour la date et l'heure actuelles
    val now: LocalDateTime = Clock.System.now().toLocalDateTime(TimeZone.currentSystemDefault())
    println("Date actuelle : \\$now")

    // Ajoutons 30 jours à l'actualité
    val futureDate = now.plus(DateTimePeriod(days = 30))
    println("Date dans 30 jours : \\$futureDate")
}

L'exemple ci-dessus montre comment récupérer la date actuelle et comment ajouter une période à cette date. En exploitant les différentes méthodes de kotlinx.datetime, vous pouvez créer des applications robustes traitant efficacement de la logique temporelle.