DateTime Structure

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

Représente un instant, généralement exprimé sous la forme d’une date ou d’une heure.

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System::Runtime::Serialization::ISerializable

public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System.Runtime.Serialization.ISerializable

type DateTime = struct
    interface IConvertible
    interface IFormattable
    interface IParsable<DateTime>
    interface ISpanFormattable
    interface ISpanParsable<DateTime>
    interface ISerializable
    interface IUtf8SpanFormattable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IParsable(Of DateTime), ISerializable, ISpanFormattable, ISpanParsable(Of DateTime), IUtf8SpanFormattable

Héritage

Object

ValueType

DateTime

Implémente

IComparable IComparable<DateTime> IConvertible IEquatable<DateTime> IFormattable ISerializable ISpanFormattable IParsable<DateTime> IParsable<TSelf> ISpanParsable<DateTime> IUtf8SpanFormattable

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour DateTime.

Constructeurs

DateTime(DateOnly, TimeOnly)	Initialise une nouvelle instance de la DateTime structure au spécifié DateOnly et TimeOnly. La nouvelle instance aura le Unspecified type .
DateTime(DateOnly, TimeOnly, DateTimeKind)	Initialise une nouvelle instance de la DateTime structure au spécifié DateOnly et TimeOnly en respectant le spécifié DateTimeKind.
DateTime(Int32, Int32, Int32)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois et le jour spécifiés.
DateTime(Int32, Int32, Int32, Calendar)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois et le jour spécifiés pour le calendrier spécifié.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute et la seconde spécifiés.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute et la seconde spécifiés pour le calendrier spécifié.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde et l'heure UTC ou locale.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde et la milliseconde spécifiés.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde et la milliseconde spécifiés pour le calendrier spécifié.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'heure UTC ou locale spécifiés pour le calendrier spécifié.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'heure UTC ou locale.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'heure UTC ou locale spécifiés pour le calendrier spécifié.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'heure UTC ou locale spécifiés pour le calendrier spécifié.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'heure UTC ou locale spécifiés pour le calendrier spécifié.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Initialise une nouvelle instance de la structure DateTime avec l'année, le mois, le jour, l'heure, la minute, la seconde, la milliseconde et l'heure UTC ou locale spécifiés pour le calendrier spécifié.
DateTime(Int64)	Initialise une nouvelle instance de la structure DateTime avec le nombre de graduations spécifié.
DateTime(Int64, DateTimeKind)	Initialise une nouvelle instance de la structure DateTime avec un nombre spécifié de graduations et une heure UTC ou locale.

Champs

MaxValue	Représente la plus grande valeur possible de DateTime. Ce champ est en lecture seule.
MinValue	Représente la plus petite valeur possible de DateTime. Ce champ est en lecture seule.
UnixEpoch	La valeur de cette constante est équivalente à 00:00:00.0000000 UTC, le 1er janvier 1970, dans le calendrier grégorien. UnixEpoch définit le point dans le temps lorsque l’heure Unix est égale à 0.

Propriétés

Date	Obtient le composant « date » de cette instance.
Day	Obtient le jour du mois représenté par cette instance.
DayOfWeek	Obtient le jour de semaine représenté par cette instance.
DayOfYear	Obtient le jour de l'année représenté par cette instance.
Hour	Obtient le composant « heure » de la date représentée par cette instance.
Kind	Obtient une valeur qui indique si l'heure représentée par cette instance se base sur l'heure locale, l'heure UTC, ou aucune des deux.
Microsecond	Composant de microsecondes, exprimé sous la forme d’une valeur comprise entre 0 et 999.
Millisecond	Obtient le composant « millisecondes » de la date représentée par cette instance.
Minute	Obtient le composant « minutes » de la date représentée par cette instance.
Month	Obtient le composant « mois » de la date représentée par cette instance.
Nanosecond	Composant nanosecondes, exprimé sous la forme d’une valeur comprise entre 0 et 900 (par incréments de 100 nanosecondes).
Now	Obtient un objet DateTime qui a pour valeur la date et l'heure actuelles sur cet ordinateur, exprimées en heure locale.
Second	Obtient le composant « secondes » de la date représentée par cette instance.
Ticks	Obtient le nombre de graduations représentant la date et l'heure de cette instance.
TimeOfDay	Obtient l'heure de cette instance.
Today	Obtient la date actuelle.
UtcNow	Obtient un objet DateTime qui a pour valeur la date et l'heure actuelles sur cet ordinateur, exprimées en temps UTC.
Year	Obtient le composant « année » de la date représentée par cette instance.

Méthodes

Add(TimeSpan)	Retourne un nouveau DateTime qui ajoute la valeur du TimeSpan spécifié à la valeur de cette instance.
AddDays(Double)	Retourne un nouveau DateTime qui ajoute le nombre de jours spécifié à la valeur de cette instance.
AddHours(Double)	Retourne un nouveau DateTime qui ajoute le nombre d'heures spécifié à la valeur de cette instance.
AddMicroseconds(Double)	Retourne un nouveau DateTime qui ajoute le nombre de microsecondes spécifié à la valeur de cette instance.
AddMilliseconds(Double)	Retourne un nouveau DateTime qui ajoute le nombre de millisecondes spécifié à la valeur de cette instance.
AddMinutes(Double)	Retourne un nouveau DateTime qui ajoute le nombre de minutes spécifié à la valeur de cette instance.
AddMonths(Int32)	Retourne un nouveau DateTime qui ajoute le nombre de mois spécifié à la valeur de cette instance.
AddSeconds(Double)	Retourne un nouveau DateTime qui ajoute le nombre de secondes spécifié à la valeur de cette instance.
AddTicks(Int64)	Retourne un nouveau DateTime qui ajoute le nombre de graduations spécifié à la valeur de cette instance.
AddYears(Int32)	Retourne un nouveau DateTime qui ajoute le nombre d'années spécifié à la valeur de cette instance.
Compare(DateTime, DateTime)	Compare deux instances de DateTime et retourne un entier qui indique si la première instance est antérieure, identique ou ultérieure à la deuxième instance.
CompareTo(DateTime)	Compare la valeur de cette instance à une valeur DateTime spécifiée et retourne un entier qui indique si cette instance est antérieure, identique ou ultérieure à la valeur DateTime spécifiée.
CompareTo(Object)	Compare la valeur de cette instance à un objet spécifié qui contient une valeur DateTime spécifiée, et retourne un entier qui indique si cette instance est antérieure, identique ou ultérieure à la valeur DateTime spécifiée.
DaysInMonth(Int32, Int32)	Retourne le nombre de jours compris dans le mois et l'année spécifiés.
Deconstruct(DateOnly, TimeOnly)	Déconstruit cette DateTime instance par DateOnly et TimeOnly.
Deconstruct(Int32, Int32, Int32)	Déconstruit cette DateOnly instance par Year, Monthet Day.
Equals(DateTime)	Renvoie une valeur indiquant si la valeur de cette instance est égale à la valeur de l'instance DateTime spécifiée.
Equals(DateTime, DateTime)	Retourne une valeur indiquant si deux DateTime instances ont la même valeur de date et d’heure.
Equals(Object)	Retourne une valeur indiquant si cette instance équivaut à un objet spécifié.
FromBinary(Int64)	Désérialise une valeur binaire 64 bits et recrée un objet DateTime sérialisé d'origine.
FromFileTime(Int64)	Convertit l'heure de fichier Windows spécifiée en heure locale équivalente.
FromFileTimeUtc(Int64)	Convertit l'heure de fichier Windows spécifiée en heure UTC équivalente.
FromOADate(Double)	Retourne un DateTime qui équivaut à la date OLE Automation spécifiée.
GetDateTimeFormats()	Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par les spécificateurs de format de date et d'heure standard.
GetDateTimeFormats(Char)	Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par le spécificateur de format de date et d'heure standard spécifié.
GetDateTimeFormats(Char, IFormatProvider)	Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par le spécificateur de format de date et d'heure standard spécifié et les données de format propres à la culture.
GetDateTimeFormats(IFormatProvider)	Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par les spécificateurs de format de date et d'heure standard spécifié et les données de format propres à la culture spécifiées.
GetHashCode()	Retourne le code de hachage de cette instance.
GetTypeCode()	Retourne le TypeCode du type valeur DateTime.
IsDaylightSavingTime()	Indique si cette instance de DateTime est dans la plage d'heures d'été pour le fuseau horaire actuel.
IsLeapYear(Int32)	Retourne une indication confirmant si l'année spécifiée est une année bissextile.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analyse une étendue de caractères dans une valeur.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Convertit une étendue de mémoire contenant la représentation sous forme de chaîne d’une date/heure en son équivalent DateTime en utilisant les informations de format propres à la culture et un style de mise en forme.
Parse(String)	Convertit la représentation sous forme de chaîne d’une date et d’une heure en son DateTime équivalent à l’aide des conventions de la culture actuelle.
Parse(String, IFormatProvider)	Convertit la représentation sous forme de chaîne d'une date et d'une heure en DateTime équivalent à l'aide des informations de format propres à la culture.
Parse(String, IFormatProvider, DateTimeStyles)	Convertit la représentation sous forme de chaîne d’une date/heure en son équivalent DateTime en utilisant les informations de format propres à la culture et un style de mise en forme.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Convertit la représentation sous forme d’étendue spécifiée d’une date et d’une heure en son équivalent DateTime à l’aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié, ou une exception est levée.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	Convertit la représentation sous forme d’étendue spécifiée d’une date et d’une heure en son équivalent DateTime à l’aide du tableau de formats ainsi que des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à au moins l'un des formats spécifiés, ou une exception est levée.
ParseExact(String, String, IFormatProvider)	Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime à l'aide des informations de format propres à la culture et au format spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié.
ParseExact(String, String, IFormatProvider, DateTimeStyles)	Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTime équivalent à l'aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié, ou une exception est levée.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	Convertit la représentation sous forme de chaîne spécifiée d'une date et heure en son équivalent DateTime à l'aide du tableau de formats, des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à au moins l'un des formats spécifiés, ou une exception est levée.
SpecifyKind(DateTime, DateTimeKind)	Crée un objet DateTime qui a le même nombre de graduations que le DateTime spécifié, mais qui est désigné comme une heure locale, une heure UTC ou aucune des deux, en fonction de ce que la valeur DateTimeKind spécifiée indique.
Subtract(DateTime)	Retourne un nouveau TimeSpan qui soustrait la date et l’heure spécifiées de la valeur de cette instance.
Subtract(TimeSpan)	Retourne un nouveau DateTime qui soustrait la durée spécifiée de la valeur de cette instance.
ToBinary()	Sérialise l'objet DateTime actuel en une valeur binaire 64 bits qui pourra ensuite être utilisée pour recréer l'objet DateTime.
ToFileTime()	Convertit la valeur de l'objet DateTime actuel en heure de fichier Windows.
ToFileTimeUtc()	Convertit la valeur de l'objet DateTime actuel en heure de fichier Windows.
ToLocalTime()	Convertit la valeur de l'objet DateTime actuel en heure locale.
ToLongDateString()	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne de date longue équivalente.
ToLongTimeString()	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne d'heure longue équivalente.
ToOADate()	Convertit la valeur de cette instance en date OLE Automation équivalente.
ToShortDateString()	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne de date courte équivalente.
ToShortTimeString()	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne d'heure courte équivalente.
ToString()	Convertit la valeur de l’objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l’aide des conventions de mise en forme de la culture actuelle.
ToString(IFormatProvider)	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l'aide des informations de format propres à la culture spécifiées.
ToString(String)	Convertit la valeur de l’objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié et des conventions de mise en forme de la culture actuelle.
ToString(String, IFormatProvider)	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de format spécifiques à la culture spécifiés.
ToUniversalTime()	Convertit la valeur de l'objet DateTime actuel en Temps universel coordonné (UTC).
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tente de mettre en forme la valeur de l’instance actuelle en UTF-8 dans l’étendue d’octets fournie.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tente de mettre en forme la valeur de l’instance datetime actuelle dans l’étendue de caractères fournie.
TryParse(ReadOnlySpan<Char>, DateTime)	Convertit l’étendue de caractères spécifiée d’une date et d’une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)	Tente d’analyser une étendue de caractères dans une valeur.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Convertit la représentation sous forme d’étendue d’une date et d’une heure en son équivalent DateTime à l’aide des informations de format et du style de mise en forme propres à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi.
TryParse(String, DateTime)	Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.
TryParse(String, IFormatProvider, DateTime)	Tente d’analyser une chaîne en une valeur.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en son équivalent DateTime à l'aide des informations de format et du style de mise en forme propres à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Convertit la représentation sous forme d’étendue spécifiée d’une date et d’une heure en son équivalent DateTime à l’aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié. La méthode retourne une valeur qui indique si la conversion a réussi.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)	Convertit l’étendue de caractères spécifiée d’une date et d’une heure en son équivalent DateTime et retourne une valeur qui indique si la conversion a réussi.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	Convertit la représentation sous forme de chaîne spécifiée d'une date et d'une heure en DateTime équivalent à l'aide des informations et du style de format propres à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié. La méthode retourne une valeur qui indique si la conversion a réussi.
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	Convertit la représentation sous forme de chaîne spécifiée d'une date et heure en son équivalent DateTime à l'aide du tableau de formats, des informations et du style de format propres à la culture spécifiés. Le format de la chaîne doit correspondre exactement à au moins un des formats spécifiés. La méthode retourne une valeur qui indique si la conversion a réussi.

Opérateurs

Addition(DateTime, TimeSpan)	Ajoute un intervalle de temps spécifié à une date et une heure spécifiées, générant une nouvelle date et heure.
Equality(DateTime, DateTime)	Détermine si deux instances spécifiées de DateTime sont égales.
GreaterThan(DateTime, DateTime)	Détermine si un DateTime spécifié est ultérieur à un autre DateTime spécifié.
GreaterThanOrEqual(DateTime, DateTime)	Détermine si un DateTime spécifié représente une date et une heure identiques ou ultérieures à un autre DateTime spécifié.
Inequality(DateTime, DateTime)	Détermine si deux instances spécifiées de DateTime ne sont pas égales.
LessThan(DateTime, DateTime)	Détermine si un DateTime spécifié est antérieur à un autre DateTime spécifié.
LessThanOrEqual(DateTime, DateTime)	Détermine si un DateTime spécifié représente une date et une heure identiques ou antérieures à un autre DateTime spécifié.
Subtraction(DateTime, DateTime)	Soustrait une date et une heure spécifiées des autres date et heure spécifiées, et retourne un intervalle de temps.
Subtraction(DateTime, TimeSpan)	Soustrait un intervalle de temps spécifié d'une date et d'une heure spécifiées et retourne une nouvelle date et heure.

Implémentations d’interfaces explicites

IConvertible.ToBoolean(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToByte(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToChar(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)	Retourne l'objet DateTime actuel.
IConvertible.ToDecimal(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToDouble(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToInt16(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToInt32(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToInt64(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToSByte(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToSingle(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)	Convertit l'objet DateTime actuel en objet de type spécifié.
IConvertible.ToUInt16(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Remplit un objet SerializationInfo des données nécessaires à la sérialisation de l'objet DateTime actuel.

Cohérence de thread

Tous les membres de ce type sont thread safe. Les membres qui semblent modifier l’état de l’instance retournent en fait une nouvelle instance initialisée avec la nouvelle valeur. Comme pour tout autre type, la lecture et l’écriture dans une variable partagée qui contient une instance de ce type doivent être protégées par un verrou pour garantir la sécurité du thread.

Voir aussi

• DateTimeOffset
• TimeSpan
• Calendar
• GetUtcOffset(DateTime)
• TimeZoneInfo
• Choisir entre DateTime, DateTimeOffset, TimeSpan et TimeZoneInfo
• Utilisation des calendriers
• Exemple : utilitaire de mise en forme .NET Core WinForms (C#)
• Exemple : utilitaire de mise en forme .NET Core WinForms (Visual Basic)