Lire en anglais

Partager via


DateTime.Now Propriété

Définition

Obtient un objet DateTime qui a pour valeur la date et l'heure actuelles sur cet ordinateur, exprimées en heure locale.

public static DateTime Now { get; }

Valeur de propriété

Objet dont la valeur est égale à la date et à l'heure locales actuelles.

Exemples

L’exemple suivant utilise les Now propriétés et UtcNow pour récupérer la date et l’heure locales actuelles, ainsi que la date et l’heure utc (universal coordinated) actuelles. Il utilise ensuite les conventions de mise en forme d’un certain nombre de cultures pour afficher les chaînes, ainsi que les valeurs de leurs Kind propriétés.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime localDate = DateTime.Now;
      DateTime utcDate = DateTime.UtcNow;
      String[] cultureNames = { "en-US", "en-GB", "fr-FR",
                                "de-DE", "ru-RU" } ;

      foreach (var cultureName in cultureNames) {
         var culture = new CultureInfo(cultureName);
         Console.WriteLine("{0}:", culture.NativeName);
         Console.WriteLine("   Local date and time: {0}, {1:G}",
                           localDate.ToString(culture), localDate.Kind);
         Console.WriteLine("   UTC date and time: {0}, {1:G}\n",
                           utcDate.ToString(culture), utcDate.Kind);
      }
   }
}
// The example displays the following output:
//       English (United States):
//          Local date and time: 6/19/2015 10:35:50 AM, Local
//          UTC date and time: 6/19/2015 5:35:50 PM, Utc
//
//       English (United Kingdom):
//          Local date and time: 19/06/2015 10:35:50, Local
//          UTC date and time: 19/06/2015 17:35:50, Utc
//
//       français (France):
//          Local date and time: 19/06/2015 10:35:50, Local
//          UTC date and time: 19/06/2015 17:35:50, Utc
//
//       Deutsch (Deutschland):
//          Local date and time: 19.06.2015 10:35:50, Local
//          UTC date and time: 19.06.2015 17:35:50, Utc
//
//       русский (Россия):
//          Local date and time: 19.06.2015 10:35:50, Local
//          UTC date and time: 19.06.2015 17:35:50, Utc

Remarques

La Now propriété retourne une DateTime valeur qui représente la date et l’heure actuelles sur l’ordinateur local. Notez qu’il existe une différence entre une DateTime valeur, qui représente le nombre de cycles écoulés depuis minuit du 1er janvier 0001, et la représentation sous forme de chaîne de cette DateTime valeur, qui exprime une valeur de date et d’heure dans un format spécifique à la culture. Pour plus d’informations sur la mise en forme des valeurs de date et d’heure, consultez la ToString méthode . L’exemple suivant affiche la chaîne de date et d’heure courte dans un certain nombre de formats spécifiques à la culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime localDate = DateTime.Now;
      String[] cultureNames = { "en-US", "en-GB", "fr-FR",
                                "de-DE", "ru-RU" };

      foreach (var cultureName in cultureNames) {
         var culture = new CultureInfo(cultureName);
         Console.WriteLine("{0}: {1}", cultureName,
                           localDate.ToString(culture));
      }
   }
}
// The example displays the following output:
//       en-US: 6/19/2015 10:03:06 AM
//       en-GB: 19/06/2015 10:03:06
//       fr-FR: 19/06/2015 10:03:06
//       de-DE: 19.06.2015 10:03:06
//       ru-RU: 19.06.2015 10:03:06

La résolution de cette propriété dépend du minuteur système, qui dépend du système d’exploitation sous-jacent. Elle a tendance à être comprise entre 0,5 et 15 millisecondes. Par conséquent, les appels répétés à la Now propriété dans un intervalle de temps court, par exemple dans une boucle, peuvent retourner la même valeur.

La Now propriété est fréquemment utilisée pour mesurer les performances. Toutefois, en raison de sa faible résolution, il n’est pas adapté à une utilisation comme outil d’évaluation. Une meilleure alternative consiste à utiliser la Stopwatch classe .

À compter de .NET Framework version 2.0, la valeur de retour est un DateTime dont Kind la propriété retourne DateTimeKind.Local.

Notes

Vous pouvez également utiliser la DateTimeOffset.Now propriété pour récupérer la date et l’heure locales actuelles. Il permet d’exprimer une heure locale sans ambiguïté sous la forme d’un point unique dans le temps, ce qui rend cette valeur de temps portable entre les ordinateurs.

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Voir aussi