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 klass för att hantera objekt av denna typ.

class DateTime

Metoder

MetodBeskrivning
Add(TimeSpan) constReturnerar en ny instans av DateTime klass som representerar ett datum- och tidsvärde som erhålls genom att lägga till det specificerade tidsintervallet till datum- och tidsvärdet som representeras av det aktuella objektet.
AddDays(double) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det specificerade antalet dagar.
AddHours(double) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det specificerade antalet timmar.
AddMilliseconds(double) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det specificerade antalet millisekunder.
AddMinutes(double) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det specificerade antalet minuter.
AddMonths(int) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det specificerade antalet månader.
AddSeconds(double) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det specificerade antalet sekunder.
AddTicks(int64_t) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är summan av värdet som representeras av det aktuella objektet och det specificerade antalet 100-nanosekundintervall.
AddYears(int) constReturnerar en ny instans av DateTime klass som representerar datum- och tidsvärdet som är lika med det som representeras av det aktuella objektet men med årskomponenten ökad med det specificerade antalet.
static Compare(DateTime, DateTime)Jämför två värden som representeras av de specificerade instanserna av DateTime klass 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 specificerade instansen av DateTime klass och returnerar ett värde som indikerar värdenas relativa positioner på tidslinjen.
DateTime()Skapar en instans som representerar det minsta möjliga datum- och tidsvärdet, lika med MinValue.
DateTime(int, int, int)Skapar en instans som representerar ett datum- och tidsvärde specificerat som ett visst år, månad och dag.
DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&)Skapar en instans som representerar ett datum- och tidsvärde specificerat som ett visst år, månad och dag i den specificerade 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 tick.
DateTime(int64_t, DateTimeKind, bool)Skapa en instans som representerar ett datum- och tidsvärde angivet som ett antal tick. FÖR INTERN 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 DateTime-klassen representerar samma datum- och tidsvärde.
Equals(DateTime) constAvgör om den angivna instansen av DateTime-klassen 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 DateTime-klassen till det värdet.
static FromFileTime(int64_t)Konverterar den angivna filtiden till en instans av DateTime-klassen som representerar samma datum- och tidsvärde som lokal tid.
static FromFileTimeUtc(int64_t)Konverterar den angivna filtiden till en instans av DateTime-klassen som representerar samma datum- och tidsvärde som UTC-tid.
static FromOADate(double)Returnerar en instans av DateTime-klassen som representerar datum- och tidsvärdet som motsvarar det angivna OLE Automation Date.
static FromUnixTime(time_t)Konverterar det angivna Unix-tidsvärdet till en instans av DateTime-klassen. FÖR INTERN ANVÄNDNING.
get_Date() constReturnerar en ny instans av DateTime-klassen 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 för datum- och tidsvärdet som representeras av det aktuella objektet.
get_Kind() constReturnerar värdet som indikerar om datumet och tiden som representeras av det aktuella objektet är lokalt, UTC eller ingen av delarna.
get_Millisecond() constReturnerar millisekundkomponenten för datum- och tidsvärdet som representeras av det aktuella objektet.
get_Minute() constReturnerar minutkomponenten för datum- och tidsvärdet som representeras av det aktuella objektet.
get_Month() constReturnerar det ordningsnummer för månaden i året som representeras av det aktuella objektet.
static get_Now()Returnerar en instans av DateTime-klassen som representerar den aktuella tiden som lokal tid.
get_Second() constReturnerar den andra komponenten av datum- och tidsvärdet som representeras av det aktuella objektet.
get_Ticks() constReturnerar ett antal 100‑nanosekundintervall som har passerat sedan 0:00:00 UTC den 1 januari 0001 i den gregorianska kalendern tills 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 intervallet 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 subtraktion 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 subtraktion 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) constAvgör om det aktuella objektet och det angivna DateTime-objektet representerar samma datum- och tidsvärde.
operator==(std::nullptr_t) const
operator>(DateTime) constAvgör 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) constAvgör 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 subtraktion 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ÄNDANDE.
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 de angivna formaten, kulturspecifik 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-nanosekund i tidsintervallet mellan det minsta möjliga och största möjliga DateTime-värdet.
static MaxValueEn instans av klassen DateTime som representerar det största möjliga datum- och tidsvärdet.
static constexpr MinTicksDet minsta antalet tick som en instans av DateTime klass kan representera.
static MinValueEn instans av DateTime klass som representerar det minsta möjliga datum- och tidsvärdet.
static constexpr TicksPerDayAntalet tick på en dag.
static constexpr TicksPerHourAntalet tick på en timme.
static constexpr TicksPerMicrosecondAntalet tick på en mikrosekund.
static constexpr TicksPerMillisecondAntalet tick på en millisekund.
static constexpr TicksPerMinuteAntalet tick på en minut.
static constexpr TicksPerSecondAntalet tick på en sekund.
static UnixEpochEn instans av DateTime klass 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 en 'DateTime'-klassinstans.
  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