C# Academy · Leçon

Créer des DateTimes

Now, Today et dates précises.

Créer des DateTimes est une leçon C# Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage C# Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours C# Academy comprend 4 leçons au total.

Découvrez DateTime

En C#, la structure DateTime représente un instant précis, comprenant à la fois la date et l'heure de la journée.

Elle se trouve dans l'espace de noms System, et est donc disponible dans chaque programme. Vous l'utiliserez pour les anniversaires, les horodatages, les échéances et bien plus encore.

Une valeur DateTime contient une année, un mois, un jour, une heure, une minute, une seconde et même des fractions de seconde.

DateTime.Now

La manière la plus simple d'obtenir la date et l'heure actuelles consiste à utiliser DateTime.Now. Cette propriété lit l'horloge locale de votre ordinateur.

Chaque appel fournit un nouvel instantané du moment présent. Comme le résultat dépend de l'heure d'exécution, la valeur affichée change à chaque fois.

using System;

class Program
{
    static void Main()
    {
        DateTime now = DateTime.Now;
        Console.WriteLine(now);
    }
}

La date du jour

Si seule la date vous intéresse, et non l'heure, utilisez DateTime.Today. Cette propriété renvoie minuit (00:00:00) du jour actuel.

C'est pratique pour comparer des jours, puisque la partie correspondant à l'heure est mise à zéro.

using System;

class Program
{
    static void Main()
    {
        DateTime today = DateTime.Today;
        Console.WriteLine(today.Year);
    }
}

L'heure UTC

Les ordinateurs du monde entier partagent l'UTC (temps universel coordonné). Utilisez DateTime.UtcNow pour obtenir l'heure actuelle en UTC, indépendamment de tout fuseau horaire local.

L'UTC est le choix sûr pour les serveurs et pour stocker des horodatages qui seront lus dans de nombreuses régions.

using System;

class Program
{
    static void Main()
    {
        DateTime utc = DateTime.UtcNow;
        Console.WriteLine(utc.Kind);
    }
}

Construire une date précise

Pour créer une date exacte, utilisez le constructeur new DateTime(year, month, day). La partie correspondant à l'heure prend par défaut la valeur minuit.

C'est idéal pour les dates fixes, comme un jour férié ou une date de lancement. Comme la valeur est fixe, la sortie est entièrement prévisible.

using System;

class Program
{
    static void Main()
    {
        DateTime launch = new DateTime(2024, 1, 15);
        Console.WriteLine(launch.ToString("yyyy-MM-dd"));
    }
}

Ajouter l'heure de la journée

Un constructeur plus long vous permet de définir les heures, les minutes et les secondes : new DateTime(year, month, day, hour, minute, second).

Les heures utilisent le format sur 24 heures : 14 signifie donc 2 PM. Vous obtenez ainsi un horodatage complet à la seconde près.

using System;

class Program
{
    static void Main()
    {
        DateTime meeting = new DateTime(2024, 3, 5, 14, 30, 0);
        Console.WriteLine(meeting);
    }
}

Lire les différentes parties

Une fois que vous disposez d'un DateTime, vous pouvez lire chaque partie grâce aux propriétés suivantes : Year, Month, Day, Hour, Minute et Second.

Ces propriétés renvoient de simples entiers, ce qui les rend faciles à afficher ou à comparer.

using System;

class Program
{
    static void Main()
    {
        DateTime d = new DateTime(2024, 3, 5, 14, 30, 0);
        Console.WriteLine(d.Month);
        Console.WriteLine(d.Hour);
    }
}

Le jour de la semaine

La propriété DayOfWeek indique le jour de la semaine correspondant à une date. Elle renvoie une valeur de l'énumération DayOfWeek, comme Monday ou Saturday.

Il existe également DayOfYear, un entier compris entre 1 et 366.

using System;

class Program
{
    static void Main()
    {
        DateTime d = new DateTime(2024, 1, 1);
        Console.WriteLine(d.DayOfWeek);
    }
}

Valeurs minimales et maximales

DateTime possède deux constantes particulières. DateTime.MinValue correspond au 1er janvier de l'an 1, et DateTime.MaxValue au 31 décembre de l'an 9999.

Elles sont utiles comme valeurs par défaut ou valeurs sentinelles lorsqu'aucune date réelle n'a encore été définie.

using System;

class Program
{
    static void Main()
    {
        Console.WriteLine(DateTime.MinValue);
        Console.WriteLine(DateTime.MaxValue.Year);
    }
}

Analyser une chaîne de date

Le texte saisi par un utilisateur ou provenant d'un fichier contient souvent une date. DateTime.Parse convertit une chaîne en valeur DateTime.

Si le texte ne correspond pas à une date valide, Parse génère une erreur. Pour une gestion plus sûre, vous pouvez utiliser DateTime.TryParse, qui renvoie true ou false au lieu de provoquer l'arrêt du programme.

using System;

class Program
{
    static void Main()
    {
        DateTime d = DateTime.Parse("2024-07-04");
        Console.WriteLine(d.Year);
    }
}

Analyser en toute sécurité avec TryParse

DateTime.TryParse évite les exceptions. Cette méthode prend le texte et une variable out, puis renvoie true en cas de réussite.

Ce modèle est recommandé pour gérer une entrée incertaine, comme une valeur saisie par un utilisateur.

using System;

class Program
{
    static void Main()
    {
        bool ok = DateTime.TryParse("not a date", out DateTime result);
        Console.WriteLine(ok);
    }
}

Vérification rapide

Vous voulez uniquement la date actuelle, sans composante horaire (à minuit). Quel appel devez-vous utiliser ?

Récapitulatif

Vous avez appris à créer des valeurs DateTime. Utilisez DateTime.Now pour l'instant local, DateTime.Today pour obtenir aujourd'hui à minuit et DateTime.UtcNow pour l'heure universelle.

Construisez des dates fixes avec new DateTime(...), lisez leurs différentes parties grâce à Year, Month et DayOfWeek, puis convertissez du texte avec Parse ou avec la méthode plus sûre TryParse.

Questions Fréquemment Posées

La leçon « Créer des DateTimes » est-elle gratuite ?

Oui — le texte complet de « Créer des DateTimes » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours C# Academy, passe à CoddyKit PRO. Le cours C# Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Créer des DateTimes » ?

Now, Today et dates précises. Tu pratiques C# Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer C# Academy ?

Aucune expérience préalable n'est requise. C# Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Créer des DateTimes » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon C# Academy ?

Oui. Chaque leçon C# Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à C# Academy