Classe System::DateTime

DateTime class

Représente une valeur de date et d’heure spécifique sur le continuum temporel. Ce type doit être alloué sur la pile et passé aux fonctions par valeur ou par référence. N’utilisez jamais la classe System::SmartPtr pour gérer les objets de ce type.

class DateTime

Méthodes

MéthodeDescription
Add(TimeSpan) constRenvoie une nouvelle instance de la classe DateTime qui représente une valeur de date et d’heure résultant de l’ajout de l’intervalle de temps spécifié à la valeur de date et d’heure représentée par l’objet actuel.
AddDays(double) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et du nombre de jours spécifié.
AddHours(double) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et du nombre d’heures spécifié.
AddMilliseconds(double) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et du nombre de millisecondes spécifié.
AddMinutes(double) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et du nombre de minutes spécifié.
AddMonths(int) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et du nombre de mois spécifié.
AddSeconds(double) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et du nombre de secondes spécifié.
AddTicks(int64_t) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et du nombre d’intervalles de 100 nanosecondes spécifié.
AddYears(int) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure égale à celle représentée par l’objet actuel avec le composant année augmenté du nombre spécifié.
static Compare(DateTime, DateTime)Compare deux valeurs représentées par les instances spécifiées de la classe DateTime et renvoie la valeur indiquant la position relative des valeurs sur la ligne du temps.
CompareTo(DateTime) constCompare deux valeurs de date et d’heure représentées par l’objet actuel et l’instance spécifiée de la classe DateTime et renvoie la valeur indiquant la position relative des valeurs sur la ligne du temps.
DateTime()Construit une instance qui représente la plus petite valeur possible de date et d’heure, égale à MinValue.
DateTime(int, int, int)Construit une instance qui représente une valeur de date et d’heure spécifiée par une année, un mois et un jour particuliers.
DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&)Construit une instance qui représente une valeur de date et d’heure spécifiée par une année, un mois et un jour particuliers dans le calendrier spécifié.
DateTime(int, int, int, int, int, int)Construit une instance qui représente une valeur de date et d’heure spécifiée par une année, un mois, un jour, une heure, une minute et une seconde particuliers.
DateTime(int, int, int, int, int, int, DateTimeKind)Construit une instance qui représente une valeur de date et d’heure spécifiée par une année, un mois, un jour, une heure, une minute et une seconde particuliers.
DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&)Construit une instance qui représente une valeur de date et d’heure spécifiée par une année, un mois, un jour, une heure, une minute et une seconde particuliers dans le calendrier spécifié.
DateTime(int, int, int, int, int, int, int, DateTimeKind)Construit une instance qui représente une valeur de date et d’heure spécifiée par une année, un mois, un jour, une heure, une minute, une seconde et une milliseconde particuliers.
DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind)Construit une instance qui représente une valeur de date et d’heure spécifiée par une année, un mois, un jour, une heure, une minute, une seconde et une milliseconde particuliers dans le calendrier spécifié.
DateTime(int64_t, DateTimeKind)Construit une instance qui représente une valeur de date et d’heure spécifiée par un nombre de ticks.
DateTime(int64_t, DateTimeKind, bool)Construit une instance qui représente une valeur de date et d’heure spécifiée par un nombre de ticks. POUR USAGE INTERNE.
DateTime(const DateTime&)Copie-constructeur d’une instance.
static DaysInMonth(int, int)Renvoie le nombre de jours dans le mois spécifié de l’année spécifiée.
static Equals(DateTime, DateTime)Détermine si les instances spécifiées de la classe DateTime représentent la même valeur de date et d’heure.
Equals(DateTime) constDétermine si l’instance spécifiée de la classe DateTime représente la même valeur de date et d’heure que l’objet actuel.
static FromBinary(int64_t)Désérialise la valeur de date et heure à partir de l’entier non signé 64 bits spécifié et définit la nouvelle instance de la classe DateTime sur cette valeur.
static FromFileTime(int64_t)Convertit le temps de fichier spécifié en une instance de la classe DateTime représentant la même valeur de date et d’heure que l’heure locale.
static FromFileTimeUtc(int64_t)Convertit le temps de fichier spécifié en une instance de la classe DateTime représentant la même valeur de date et d’heure que l’heure UTC.
static FromOADate(double)Renvoie une instance de la classe DateTime représentant la valeur de date et d’heure équivalente à la date d’automatisation OLE spécifiée.
static FromUnixTime(time_t)Convertit la valeur de temps Unix spécifiée en une instance de la classe DateTime. POUR USAGE INTERNE.
get_Date() constRenvoie une nouvelle instance de la classe DateTime qui représente la partie date de la date et de l’heure représentées par l’objet actuel, chaque composant de la partie temps étant mis à 0.
get_Day() constRenvoie le numéro ordinal du jour dans le mois représenté par l’objet actuel.
get_DayOfWeek() constRenvoie une valeur représentant le jour de la semaine représenté par l’objet actuel.
get_DayOfYear() constRenvoie le numéro ordinal du jour dans l’année représentée par l’objet actuel.
get_Hour() constRenvoie le composant heure de la valeur de date et d’heure représentée par l’objet actuel.
get_Kind() constRenvoie la valeur indiquant si la date et l’heure représentées par l’objet actuel sont une date et heure locales, UTC ou aucune des deux.
get_Millisecond() constRenvoie le composant milliseconde de la valeur de date et d’heure représentée par l’objet actuel.
get_Minute() constRenvoie le composant minute de la valeur de date et d’heure représentée par l’objet actuel.
get_Month() constRenvoie le numéro ordinal du mois dans l’année représentée par l’objet actuel.
static get_Now()Renvoie une instance de la classe DateTime qui représente l’heure actuelle en heure locale.
get_Second() constRenvoie le composant seconde de la valeur de date et d’heure représentée par l’objet actuel.
get_Ticks() constRenvoie un nombre d’intervalles de 100 nanosecondes écoulés depuis le 0 h 00 min 00 s UTC, 1 janvier 0001, dans le calendrier grégorien jusqu’à la date et l’heure représentées par l’objet actuel.
get_TimeOfDay() constRenvoie la valeur qui représente l’intervalle de temps depuis le début du jour représenté par l’objet actuel jusqu’à la valeur de date et d’heure représentée par l’objet actuel.
static get_Today()Renvoie une instance de la classe DateTime qui représente la date actuelle avec chaque composant de la partie temps de la valeur représentée par l’objet mis à 0.
static get_UtcNow()Renvoie une instance de la classe DateTime qui représente l’heure actuelle en UTC.
get_Year() constRenvoie l’année représentée par l’objet actuel.
GetDateComponents(int&, int&, int&) constObtient les parties de la date. POUR USAGE INTERNE.
GetDateTimeFormats() constRenvoie un tableau de chaînes où chaque élément est la représentation sous forme de chaîne de l’objet actuel formatée avec l’un des spécificateurs de format de date et d’heure standard.
GetDateTimeFormats(char_t) constRenvoie un tableau de chaînes où chaque élément est la représentation sous forme de chaîne de l’objet actuel formatée avec le spécificateur de format de date et d’heure standard spécifié.
GetDateTimeFormats(const SharedPtr<IFormatProvider>&) constRenvoie un tableau de chaînes où chaque élément est la représentation sous forme de chaîne de l’objet actuel formatée avec l’un des spécificateurs de format de date et d’heure standard et le fournisseur de format spécifié.
GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) constRenvoie un tableau de chaînes où chaque élément est la représentation sous forme de chaîne de l’objet actuel formaté avec le spécificateur de format de date et d’heure standard spécifié et le fournisseur de format.
GetHashCode() constRenvoie un code de hachage pour l’objet actuel.
IsDaylightSavingTime() constDétermine si la valeur de date et d’heure représentée par l’objet actuel se situe dans la plage de l’heure d’été pour le fuseau horaire actuel.
static IsLeapYear(int)Détermine si l’année spécifiée est une année bissextile.
IsNull() const
operator!=(DateTime) constDétermine si l’objet actuel et l’objet DateTime spécifié représentent des valeurs de date et d’heure distinctes.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constRenvoie une nouvelle instance de la classe DateTime qui représente la valeur de date et d’heure résultant de la somme de la valeur représentée par l’objet actuel et de l’intervalle de temps spécifié.
operator+=(TimeSpan)Définit l’objet actuel sur la valeur de date et d’heure qui est la somme de la valeur représentée par l’objet actuel et de l’intervalle de temps spécifié.
operator-(TimeSpan) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui résulte de la soustraction de l’intervalle de temps spécifié de la valeur représentée par l’objet actuel.
operator-(DateTime) constRenvoie une instance de la classe TimeSpan qui représente l’intervalle de temps entre les valeurs de date et d’heure représentées par les objets actuel et spécifié.
operator-=(TimeSpan)Définit l’objet actuel sur la valeur de date et d’heure qui résulte de la soustraction de l’intervalle de temps spécifié de la valeur de date et d’heure représentée par l’objet actuel.
operator<(DateTime) constDétermine si l’objet actuel représente la valeur de date et d’heure qui est antérieure à la valeur représentée par l’objet DateTime spécifié.
operator<(std::nullptr_t) const
operator<=(DateTime) constDétermine si l’objet actuel représente la valeur de date et d’heure qui est antérieure ou égale à la valeur représentée par l’objet DateTime spécifié.
operator<=(std::nullptr_t) const
operator=(const DateTime&)Attribue la valeur représentée par l’instance DateTime spécifiée à l’objet actuel.
operator==(DateTime) constDétermine si l’objet actuel et l’objet DateTime spécifié représentent la même valeur de date et d’heure.
operator==(std::nullptr_t) const
operator>(DateTime) constDétermine si l’objet actuel représente la valeur de date et d’heure qui est postérieure à la valeur représentée par l’objet DateTime spécifié.
operator>(std::nullptr_t) const
operator>=(DateTime) constDétermine si l’objet actuel représente la valeur de date et d’heure qui est postérieure ou égale à la valeur représentée par l’objet DateTime spécifié.
operator>=(std::nullptr_t) const
static Parse(const String&)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent.
static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent en utilisant des informations de format spécifiques à la culture.
static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static Parse(const String&, std::nullptr_t, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent en utilisant le format spécifié et des informations de format spécifiques à la culture. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié. Lève une exception si la conversion échoue.
static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent en utilisant les formats spécifiés, des informations de format spécifiques à la culture et le style. Le format de la représentation sous forme de chaîne doit correspondre exactement à un ou plusieurs des formats spécifiés. Lève une exception si la conversion échoue.
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles)
static SpecifyKind(DateTime, DateTimeKind)Construit un nouvel objet DateTime qui représente le même nombre de ticks que l’objet DateTime spécifié et représente l’heure locale, l’heure UTC ou aucune des deux selon l’argument kind.
Subtract(TimeSpan) constRenvoie une nouvelle instance de la classe DateTime représentant la valeur de date et d’heure qui résulte de la soustraction de l’intervalle de temps spécifié de la valeur représentée par l’objet actuel.
Subtract(DateTime) constRenvoie une instance de la classe TimeSpan représentant l’intervalle de temps entre les valeurs de date et d’heure représentées par les objets actuel et spécifié.
ToBinary() constSérialise l’objet actuel.
ToFileTime() constRenvoie une valeur qui représente la valeur de date et d’heure représentée par l’objet actuel sous forme de temps de fichier.
ToFileTimeUtc() constConvertit la valeur de date et d’heure représentée par l’objet actuel en temps de fichier UTC.
ToLocalTime() constRenvoie une nouvelle instance de la classe DateTime qui représente la valeur de date et d’heure représentée par l’objet actuel en heure locale.
ToLongDateString() constRenvoie une chaîne qui contient la représentation sous forme de chaîne de date longue de l’objet actuel.
ToLongTimeString() constRenvoie une chaîne qui contient la représentation sous forme de chaîne de l’heure longue de l’objet actuel.
ToOADate() constRenvoie la valeur de date et d’heure représentée par l’objet actuel sous forme de OLE Automation Date.
ToShortDateString() constRenvoie une chaîne qui contient la représentation sous forme de chaîne de la date courte de l’objet actuel.
ToShortTimeString() constRenvoie une chaîne qui contient la représentation sous forme de chaîne de l’heure courte de l’objet actuel.
ToString() constRenvoie la représentation sous forme de chaîne de la valeur de date et d’heure représentée par l’objet actuel en utilisant les conventions de formatage définies par la culture actuelle.
ToString(const String&) constRenvoie une représentation sous forme de chaîne de la valeur de date et d’heure représentée par l’objet actuel en utilisant le format spécifié et les conventions de formatage définies par la culture actuelle.
ToString(const SharedPtr<IFormatProvider>&) constRenvoie une représentation sous forme de chaîne de la valeur de date et d’heure représentée par l’objet actuel en utilisant les informations de format spécifiées.
ToString(const SharedPtr<Globalization::CultureInfo>&) const
ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(std::nullptr_t) const
ToString(const String&, const SharedPtr<IFormatProvider>&) constRenvoie une représentation sous forme de chaîne de la valeur de date et d’heure représentée par l’objet actuel en utilisant les informations de format spécifiées.
ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const
ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(const String&, std::nullptr_t) const
ToUniversalTime() constRenvoie une nouvelle instance de la classe DateTime qui représente la valeur de date et d’heure représentée par l’objet actuel en UTC.
ToUnixTime() constRenvoie une valeur qui représente la valeur de date et d’heure représentée par l’objet actuel sous forme de temps Unix. POUR USAGE INTERNE.
static TryParse(const String&, DateTime&)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent en utilisant les informations de format spécifiques à la culture et le style spécifiés.
static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParse(const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent en utilisant le format spécifié, les informations de format spécifiques à la culture et le style. Le format de la représentation sous forme de chaîne doit correspondre exactement au format spécifié.
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Convertit la représentation sous forme de chaîne spécifiée d’une valeur de date et d’heure en l’objet DateTime équivalent en utilisant les formats spécifiés, les informations de format spécifiques à la culture et le style. Le format de la représentation sous forme de chaîne doit correspondre exactement à un ou plusieurs des formats spécifiés.
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static Type()Renvoie un objet TypeInfo qui contient des informations sur cette classe.

Champs

ChampDescription
static constexpr MaxTicksLe nombre de 100 nanosecondes dans l’intervalle de temps entre la valeur DateTime minimale possible et maximale possible.
static MaxValueUne instance de la classe DateTime qui représente la valeur de date et d’heure maximale possible.
static constexpr MinTicksLe nombre minimal de ticks qu’une instance de la classe DateTime peut représenter.
static MinValueUne instance de la classe DateTime qui représente la valeur de date et d’heure minimale possible.
static constexpr TicksPerDayLe nombre de ticks dans une journée.
static constexpr TicksPerHourLe nombre de ticks dans une heure.
static constexpr TicksPerMicrosecondLe nombre de ticks dans une microseconde.
static constexpr TicksPerMillisecondLe nombre de ticks dans une milliseconde.
static constexpr TicksPerMinuteLe nombre de ticks dans une minute.
static constexpr TicksPerSecondLe nombre de ticks dans une seconde.
static UnixEpochUne instance de la classe DateTime qui représente le début de l’époque Unix (1970.01.01 00:00:00).

Remarques

#include "system/console.h"
#include "system/date_time.h"

int main()
{
  using namespace System;

  // Créez l'instance de la classe 'DateTime'.
  DateTime dateTime{1990, 10, 30};

  // Imprimez l'instance dans plusieurs formats.
  Console::WriteLine(dateTime.ToShortDateString());
  Console::WriteLine(dateTime.ToShortTimeString());
  Console::WriteLine(dateTime.ToString());

  return 0;
}
/*
This code example produces the following output:
30.10.1990
0:00
30.10.1990 0:00:00
*/

Voir aussi