System::DateTime-klass

DateTime class

Representerar ett specifikt datum- och tidsvärde på tidskontinuumet. Denna typ bör allokeras på stacken och skickas till funktioner som värde eller referens. Använd aldrig System::SmartPtr‑klassen för att hantera objekt av denna typ.

class DateTime

Metoder

MetodBeskrivning
Add(TimeSpan) constReturnerar en ny instans av DateTime-klassen som representerar ett datum- och tidsvärde som erhålls genom att lägga till det angivna tidsintervallet till datum- och tidsvärdet som representeras av det aktuella objektet.
AddDays(double) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna antalet dagar.
AddHours(double) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna antalet timmar.
AddMilliseconds(double) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna antalet millisekunder.
AddMinutes(double) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna antalet minuter.
AddMonths(int) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna antalet månader.
AddSeconds(double) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna antalet sekunder.
AddTicks(int64_t) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna antalet 100‑nanosekundintervall.
AddYears(int) constReturnerar en ny instans av DateTime-klassen som representerar datum- och tidsvärdet som är lika med det som representeras av det aktuella objektet men med årskomponenten ökad med det angivna antalet.
static Compare(DateTime, DateTime)Jämför två värden som representeras av de angivna instanserna av DateTime-klassen och returnerar ett värde som indikerar värdenas relativa positioner på tidslinjen.
CompareTo(DateTime) constJämför två datum- och tidsvärden som representeras av det aktuella objektet och den angivna instansen av klassen DateTime och returnerar värdet som indikerar värdenas relativa positioner på tidslinjen.
DateTime()Skapar en instans som representerar det minsta möjliga datum- och tidsvärdet som är lika med MinValue.
DateTime(int, int, int)Skapar en instans som representerar ett datum- och tidsvärde angivet som ett specifikt år, månad och dag.
DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&)Skapar en instans som representerar ett datum- och tidsvärde angivet som ett specifikt år, månad och dag i den angivna kalendern.
DateTime(int, int, int, int, int, int)Skapar en instans som representerar ett datum- och tidsvärde angivet som ett specifikt år, månad, dag, timme, minut och sekund.
DateTime(int, int, int, int, int, int, DateTimeKind)Skapar en instans som representerar ett datum- och tidsvärde angivet som ett specifikt år, månad, dag, timme, minut och sekund.
DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&)Skapar en instans som representerar ett datum- och tidsvärde angivet som ett specifikt år, månad, dag, timme, minut och sekund i den angivna kalendern.
DateTime(int, int, int, int, int, int, int, DateTimeKind)Skapar en instans som representerar ett datum- och tidsvärde angivet som ett specifikt år, månad, dag, timme, minut, sekund och millisekund.
DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind)Skapar en instans som representerar ett datum- och tidsvärde angivet som ett specifikt år, månad, dag, timme, minut, sekund och millisekund i den angivna kalendern.
DateTime(int64_t, DateTimeKind)Skapa en instans som representerar ett datum- och tidsvärde angivet som ett antal ticks.
DateTime(int64_t, DateTimeKind, bool)Skapa en instans som representerar ett datum- och tidsvärde angivet som ett antal ticks. FÖR INTERNT ANVÄNDNING.
DateTime(const DateTime&)Kopierar en instans.
static DaysInMonth(int, int)Returnerar antalet dagar i den angivna månaden för det angivna året.
static Equals(DateTime, DateTime)Avgör om de angivna instanserna av klassen DateTime representerar samma datum- och tidsvärde.
Equals(DateTime) constAvgör om den angivna instansen av klassen DateTime representerar samma datum- och tidsvärde som det aktuella objektet.
static FromBinary(int64_t)Deserialiserar datum- och tidsvärdet från det angivna osignerade 64-bitars heltalet och sätter den nya instansen av klassen DateTime till det värdet.
static FromFileTime(int64_t)Konverterar den angivna File-tiden till en instans av klassen DateTime som representerar samma datum- och tidsvärde som lokal tid.
static FromFileTimeUtc(int64_t)Konverterar den angivna File-tiden till en instans av klassen DateTime som representerar samma datum- och tidsvärde som UTC-tid.
static FromOADate(double)Returnerar en instans av klassen DateTime som representerar datum- och tidsvärdet motsvarande det angivna OLE Automation Date.
static FromUnixTime(time_t)Konverterar det angivna Unix-tidsvärdet till en instans av klassen DateTime. FÖR INTERNT ANVÄNDNING.
get_Date() constReturnerar en ny instans av klassen DateTime som representerar datumdelen av datumet och tiden som representeras av det aktuella objektet, där varje komponent i tidsdelen är satt till 0.
get_Day() constReturnerar det ordningsnummer för dagen i månaden som representeras av det aktuella objektet.
get_DayOfWeek() constReturnerar ett värde som representerar veckodagen som det aktuella objektet representerar.
get_DayOfYear() constReturnerar det ordningsnummer för dagen på året som representeras av det aktuella objektet.
get_Hour() constReturnerar timkomponenten i datum- och tidsvärdet som representeras av det aktuella objektet.
get_Kind() constReturnerar värdet som anger om datum- och tidsvärdet som representeras av det aktuella objektet är en lokal eller UTC-tid eller ingen av dem.
get_Millisecond() constReturnerar millisekundkomponenten i datum- och tidsvärdet som representeras av det aktuella objektet.
get_Minute() constReturnerar minutkomponenten i datum- och tidsvärdet som representeras av det aktuella objektet.
get_Month() constReturnerar ordningsnumret för månaden i året som representeras av det aktuella objektet.
static get_Now()Returnerar en instans av klassen DateTime som representerar den aktuella tiden som lokal tid.
get_Second() constReturnerar sekundkomponenten i datum- och tidsvärdet som representeras av det aktuella objektet.
get_Ticks() constReturnerar ett antal 100‑nanosekundintervall som har passerat sedan 00:00:00 UTC den 1 januari 0001 i den gregorianska kalendern fram till datumet och tiden som representeras av det aktuella objektet.
get_TimeOfDay() constReturnerar värdet som representerar tidsintervallet från början av dagen som representeras av det aktuella objektet till datum- och tidsvärdet som representeras av det aktuella objektet.
static get_Today()Returnerar en instans av klassen DateTime som representerar det aktuella datumet med varje komponent i tidsdelen av värdet som representeras av objektet satt till 0.
static get_UtcNow()Returnerar en instans av klassen DateTime som representerar den aktuella tiden som UTC.
get_Year() constReturnerar året som representeras av det aktuella objektet.
GetDateComponents(int&, int&, int&) constHämtar datumdelar. FÖR INTERNT BRUK.
GetDateTimeFormats() constReturnerar en array av strängar där varje element är strängrepresentationen av det aktuella objektet formaterad med en av de standardiserade datum- och tidsformatspecifierarna.
GetDateTimeFormats(char_t) constReturnerar en array av strängar där varje element är strängrepresentationen av det aktuella objektet formaterad med den angivna standardiserade datum- och tidsformatspecifieraren.
GetDateTimeFormats(const SharedPtr<IFormatProvider>&) constReturnerar en array av strängar där varje element är strängrepresentationen av det aktuella objektet formaterad med en av de standardiserade datum- och tidsformatspecifierarna och den angivna formatleverantören.
GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) constReturnerar en array av strängar där varje element är strängrepresentationen av det aktuella objektet formaterad med den angivna standardiserade datum- och tidsformatspecifieraren och formatleverantören.
GetHashCode() constReturnerar en hashkod för det aktuella objektet.
IsDaylightSavingTime() constAvgör om datum- och tidsvärdet som representeras av det aktuella objektet faller inom perioden för sommartid för den aktuella tidszonen.
static IsLeapYear(int)Avgör om det angivna året är ett skottår.
IsNull() const
operator!=(DateTime) constAvgör om det aktuella objektet och det angivna DateTime-objektet representerar olika datum- och tidsvärden.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constReturnerar en ny instans av klassen DateTime som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna tidsintervallet.
operator+=(TimeSpan)Sätter det aktuella objektet till datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det angivna tidsintervallet.
operator-(TimeSpan) constReturnerar en ny instans av klassen DateTime som representerar datum- och tidsvärdet som är resultatet av subtraktionen av det angivna tidsintervallet från värdet som representeras av det aktuella objektet.
operator-(DateTime) constReturnerar en instans av klassen TimeSpan som representerar tidsintervallet mellan datum- och tidsvärdena som representeras av det aktuella och det angivna objektet.
operator-=(TimeSpan)Sätter det aktuella objektet till datum- och tidsvärdet som är resultatet av subtraktionen av det angivna tidsintervallet från datum- och tidsvärdet som representeras av det aktuella objektet.
operator<(DateTime) constAvgör om det aktuella objektet representerar datum- och tidsvärdet som är tidigare än värdet som representeras av det angivna DateTime-objektet.
operator<(std::nullptr_t) const
operator<=(DateTime) constAvgör om det aktuella objektet representerar datum- och tidsvärdet som är tidigare än eller samma som värdet som representeras av det angivna DateTime-objektet.
operator<=(std::nullptr_t) const
operator=(const DateTime&)Tilldelar värdet som representeras av den angivna DateTime-instansen till det aktuella objektet.
operator==(DateTime) constBestämmer om det aktuella objektet och det angivna DateTime-objektet representerar samma datum- och tidsvärde.
operator==(std::nullptr_t) const
operator>(DateTime) constBestämmer om det aktuella objektet representerar datum- och tidsvärdet som är senare än värdet som representeras av det angivna DateTime-objektet.
operator>(std::nullptr_t) const
operator>=(DateTime) constBestämmer om det aktuella objektet representerar datum- och tidsvärdet som är senare än eller samma som värdet som representeras av det angivna DateTime-objektet.
operator>=(std::nullptr_t) const
static Parse(const String&)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt.
static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt med hjälp av kulturspecifik formatinformation.
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)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt med den angivna formatet och kulturspecifik formatinformation. Formatet för strängrepresentationen måste exakt matcha det angivna formatet. Kastar ett undantag om konverteringen misslyckas.
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)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt med de angivna formaten, kulturspecifik formatinformation och stil. Formatet för strängrepresentationen måste exakt matcha ett eller flera av de angivna formaten. Kastar ett undantag om konverteringen misslyckas.
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)Skapar ett nytt DateTime-objekt som representerar samma antal tickar som det angivna DateTime-objektet och representerar lokal tid, UTC-tid eller ingen av dem enligt argumentet kind.
Subtract(TimeSpan) constReturnerar en ny instans av klassen DateTime som representerar datum- och tidsvärdet som är resultatet av subtraktionen av det angivna tidsintervallet från värdet som representeras av det aktuella objektet.
Subtract(DateTime) constReturnerar en instans av klassen TimeSpan som representerar tidsintervallet mellan datum- och tidsvärdena som representeras av det aktuella och det angivna objektet.
ToBinary() constSerialiserar det aktuella objektet.
ToFileTime() constReturnerar ett värde som representerar datum- och tidsvärdet som det aktuella objektet representerar som filtid.
ToFileTimeUtc() constKonverterar datum- och tidsvärdet som det aktuella objektet representerar till filtid UTC.
ToLocalTime() constReturnerar en ny instans av klassen DateTime som representerar datum- och tidsvärdet som det aktuella objektet representerar som lokal tid.
ToLongDateString() constReturnerar en sträng som innehåller den långa datumsträngrepresentationen av det aktuella objektet.
ToLongTimeString() constReturnerar en sträng som innehåller den långa tidssträngrepresentationen av det aktuella objektet.
ToOADate() constReturnerar datum- och tidsvärdet som det aktuella objektet representerar som OLE Automation Date.
ToShortDateString() constReturnerar en sträng som innehåller den korta datumsträngrepresentationen av det aktuella objektet.
ToShortTimeString() constReturnerar en sträng som innehåller den korta tidssträngrepresentationen av det aktuella objektet.
ToString() constReturnerar strängrepresentationen av datum- och tidsvärdet som det aktuella objektet representerar med de formateringskonventioner som definieras av den aktuella kulturen.
ToString(const String&) constReturnerar en strängrepresentation av datum- och tidsvärdet som det aktuella objektet representerar med det angivna formatet och de formateringskonventioner som definieras av den aktuella kulturen.
ToString(const SharedPtr<IFormatProvider>&) constReturnerar en strängrepresentation av datum- och tidsvärdet som det aktuella objektet representerar med den angivna formatinformationen.
ToString(const SharedPtr<Globalization::CultureInfo>&) const
ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(std::nullptr_t) const
ToString(const String&, const SharedPtr<IFormatProvider>&) constReturnerar en strängrepresentation av datum- och tidsvärdet som det aktuella objektet representerar med den angivna formatinformationen.
ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const
ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(const String&, std::nullptr_t) const
ToUniversalTime() constReturnerar en ny instans av klassen DateTime som representerar datum- och tidsvärdet som det aktuella objektet representerar som UTC.
ToUnixTime() constReturnerar ett värde som representerar datum- och tidsvärdet som det aktuella objektet representerar som Unix-tid. FÖR INTERNT ANVÄNDNING.
static TryParse(const String&, DateTime&)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt med den angivna kulturspecifika formatinformationen och stil.
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&)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt med det angivna formatet, kulturspecifik formatinformation och stil. Formatet för strängrepresentationen måste exakt matcha det angivna formatet.
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&)Konverterar den angivna strängrepresentationen av ett datum- och tidsvärde till motsvarande DateTime-objekt med hjälp av de angivna formaten, kultur‑specifik formatinformation och stil. Formatet för strängrepresentationen måste exakt matcha ett eller flera av de angivna formaten.
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()Returnerar ett TypeInfo-objekt som innehåller information om denna klass.

Fält

FältBeskrivning
static constexpr MaxTicksAntalet 100‑nanosekunder i tidsintervallet mellan det minsta möjliga och det största möjliga DateTime-värdet.
static MaxValueEn instans av DateTime-klassen som representerar det största möjliga datum‑ och tidsvärdet.
static constexpr MinTicksDet minsta antalet ticks som en instans av DateTime-klassen kan representera.
static MinValueEn instans av DateTime-klassen som representerar det minsta möjliga datum‑ och tidsvärdet.
static constexpr TicksPerDayAntalet ticks på en dag.
static constexpr TicksPerHourAntalet ticks på en timme.
static constexpr TicksPerMicrosecondAntalet ticks på en mikrosekund.
static constexpr TicksPerMillisecondAntalet ticks på en millisekund.
static constexpr TicksPerMinuteAntalet ticks på en minut.
static constexpr TicksPerSecondAntalet ticks på en sekund.
static UnixEpochEn instans av DateTime-klassen som representerar Unix‑epokens start (1970-01-01 00:00:00).

Anmärkningar

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

int main()
{
  using namespace System;

  // Skapa 'DateTime'-klassinstansen.
  DateTime dateTime{1990, 10, 30};

  // Skriv ut instansen i flera format.
  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
*/

Se även