Section courante

A propos

Section administrative du site

Date et heure

Le langage de programmation C# inclut la structure DateTime pour travailler avec les dates et les heures. Pour travailler avec la date et l'heure en C#, créez un objet de la structure DateTime à l'aide du mot clef new. Le code suivant crée un objet DateTime avec la valeur par défaut :

  1. DateTime dt = new DateTime(); // assigne la valeur par défaut 01/01/0001 00:00:00

La valeur par défaut et la valeur la plus basse d'un objet DateTime est le 1er janvier 0001 00:00:00 (minuit). La valeur maximale peut être le 31 décembre 9999 23:59:59. Utilisez différents constructeurs de la structure DateTime pour affecter une valeur initiale à un objet DateTime.

  1. using System;
  2.  
  3. public class Program {
  4.      public static void Main()      {
  5.           // attribue la valeur par défaut 01/01/0001 00:00:00
  6.           DateTime dt1 = new DateTime(); 
  7.           Console.WriteLine(dt1);
  8.           // attribuer l'année, le mois, le jour
  9.           DateTime dt2 = new DateTime(2015, 12, 31);
  10.           Console.WriteLine(dt2);
  11.           // attribuer l'année, le mois, le jour, l'heure, la minute, les secondes
  12.           DateTime dt3 = new DateTime(2015, 12, 31, 5, 10, 20);
  13.           Console.WriteLine(dt3);
  14.           // attribuer l'année, le mois, le jour, l'heure, la minute, les secondes, le fuseau horaire UTC
  15.           DateTime dt4 = new DateTime(2015, 12, 31, 5, 10, 20, DateTimeKind.Utc);
  16.           Console.WriteLine(dt4);
  17.      }
  18. }

Dans l'exemple ci-dessus, nous avons spécifié une année, un mois et un jour dans le constructeur. L'année peut être comprise entre 0001 et 9999, le mois peut être compris entre 1 et 12 et le jour peut être compris entre 1 et 31. La définition de toute autre valeur en dehors de ces plages entraînera une exception d'exécution. Utilisez différents constructeurs DateTime pour définir la date, l'heure, le fuseau horaire, le calendrier et la culture.

Tics

Un tic est une date et une heure exprimées en nombre d'intervalles de 100 nanosecondes s'étant écoulés depuis le 1er janvier 0001, à 00:00:00.000 dans le calendrier grégorien. Ce qui suit initialise un objet DateTime avec le nombre de graduations :

  1. using System;
  2.  
  3. public class Program {
  4.      public static void Main() {
  5.           DateTime dt = new DateTime(637770000000000000);
  6.           Console.WriteLine(dt);
  7.           Console.WriteLine(DateTime.MaxValue.Ticks);
  8.           Console.WriteLine(DateTime.MinValue.Ticks);
  9.      }
  10. }

Champs statiques DateTime

La structure DateTime inclut des champs, des propriétés et des méthodes statiques. L'exemple suivant illustre des champs et propriétés statiques importants :

  1. using System;
  2.  
  3. public class Program {
  4.      public static void Main() {
  5.           DateTime currentDateTime = DateTime.Now; 
  6.           DateTime todaysDate = DateTime.Today; 
  7.           DateTime currentDateTimeUTC = DateTime.UtcNow; 
  8.           DateTime maxDateTimeValue = DateTime.MaxValue; 
  9.           DateTime minDateTimeValue = DateTime.MinValue;
  10.           Console.WriteLine($"DateTime courante : {currentDateTime}");
  11.           Console.WriteLine($"DateTime d'aujourd'hui : {todaysDate}");
  12.           Console.WriteLine($"Fuseau horaire UTC de DateTime UTC courante : {currentDateTimeUTC}");
  13.           Console.WriteLine($"Valeur maximal de DateTime : {maxDateTimeValue}");
  14.           Console.WriteLine($"Valeur minimal de DateTime : {minDateTimeValue}");
  15.  
  16.      }
  17. }

TimeSpan

Le TimeSpan est une structure utilisée pour représenter le temps en jours, heures, minutes, secondes et millisecondes :

  1. Using System;
  2.  
  3. public class Program {
  4.      public static void Main() {
  5.           DateTime dt = new DateTime(2021, 12, 29);
  6.           TimeSpan ts = new TimeSpan(25, 20, 55);
  7.           DateTime newDate = dt.Add(ts);
  8.           Console.WriteLine(newDate);
  9.      }
  10. }

Les opérateurs

La structure DateTime surcharge les opérateurs +, -, ==, !=, >, <, <=, >= pour faciliter l'addition, la soustraction et la comparaison de dates. Ceux-ci facilitent le travail avec les dates :

  1. using System;
  2.  
  3. public class Program
  4. {
  5.      public static void Main()
  6.      {
  7.           DateTime dt1 = new DateTime(2021, 12, 29);
  8.           DateTime dt2 = new DateTime(2021, 12, 31, 5, 10, 20);
  9.           TimeSpan time = new TimeSpan(10, 5, 25, 50);
  10.           Console.WriteLine(dt2 + time); 
  11.           Console.WriteLine(dt2 - dt1); 
  12.           Console.WriteLine(dt1 == dt2);
  13.           Console.WriteLine(dt1 != dt2);
  14.           Console.WriteLine(dt1 > dt2); 
  15.           Console.WriteLine(dt1 < dt2); 
  16.           Console.WriteLine(dt1 >= dt2);
  17.           Console.WriteLine(dt1 <= dt2);
  18.      }
  19. }

Convertir la String en DateTime

Une chaîne de caractères de date et d'heure valide peut être convertie en un objet DateTime à l'aide des méthodes Parse(), ParseExact(), TryParse() et TryParseExact(). Les méthodes Parse() et ParseExact() lèveront une exception si la chaîne de caractères spécifiée n'est pas une représentation valide d'une date et d'une heure. Il est donc recommandé d'utiliser la méthode TryParse() ou TryParseExact() car elles renvoient false si une chaîne de caractères n'est pas valide :

  1. using System;
  2.  
  3. public class Program {
  4.      public static void Main() {
  5.           var str = "2021/12/29";
  6.           DateTime dt;
  7.           var isValidDate = DateTime.TryParse(str, out dt);
  8.           if (isValidDate) Console.WriteLine(dt);
  9.                       else Console.WriteLine($"{str} n'est pas une date valide");
  10.      }
  11. }


Dernière mise à jour : Mercredi, le 29 décembre 2021