DateTime Struktúra

Definíció

Névtér:: System

Szerelvények:: mscorlib.dll, System.Runtime.dll

Szerelvény:: mscorlib.dll

Szerelvény:: System.Runtime.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy azonnali időpontot jelöl, amely általában a nap és a nap dátumaként van kifejezve.

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable

public value class DateTime : IComparable, IConvertible, IFormattable

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System::Runtime::Serialization::ISerializable

public value class DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable

public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable

[System.Serializable]
public struct DateTime : IComparable, IConvertible, IFormattable

[System.Serializable]
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable

public struct DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable

public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable

public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable

type DateTime = struct
    interface IConvertible
    interface IFormattable

[<System.Serializable>]
type DateTime = struct
    interface IFormattable
    interface IConvertible

[<System.Serializable>]
type DateTime = struct
    interface IFormattable
    interface IConvertible
    interface ISerializable

type DateTime = struct
    interface IFormattable

type DateTime = struct
    interface IConvertible
    interface IFormattable
    interface ISerializable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable

Public Structure DateTime
Implements IComparable, IConvertible, IFormattable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable, ISerializable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IEquatable(Of DateTime), IFormattable

Öröklődés: Object

ValueType
DateTime

Attribútumok: SerializableAttribute

Megvalósítás: IComparable IComparable<DateTime> IConvertible IEquatable<DateTime> IFormattable ISerializable

Megjegyzések

Az API-val kapcsolatos további információkért lásd a DateTime kiegészítő API-megjegyzéseit.

Konstruktorok

Name	Description
DateTime(Int32, Int32, Int32, Calendar)	Inicializálja a DateTime struktúra új példányát a megadott naptár adott évére, hónapjára és napjára.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializálja a struktúra új példányát a DateTime megadott naptár adott évére, hónapjára, napjára, órájára, percére és másodpercére.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializálja a struktúra új példányát a DateTime megadott évre, hónapra, napra, órára, percre, másodpercre és utc- vagy helyi idő szerint.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializálja a struktúra új példányát a DateTime megadott évre, hónapra, napra, órára, percre, másodpercre, ezredmásodpercre és az egyezményes világidőre (UTC) vagy a megadott naptár helyi idejére.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializálja a struktúra új példányát a DateTime megadott év, hónap, nap, óra, perc, másodperc és ezredmásodperc között a megadott naptárhoz.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializálja a struktúra új példányát a DateTime megadott évre, hónapra, napra, órára, percre, másodpercre, ezredmásodpercre és az egyezményes világidőre (UTC) vagy helyi idő szerint.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializálja a struktúra új példányát a DateTime megadott évre, hónapra, napra, órára, percre, másodpercre és ezredmásodpercre.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	Inicializálja a struktúra új példányát a DateTime megadott évre, hónapra, napra, órára, percre és másodpercre.
DateTime(Int32, Int32, Int32)	Inicializálja a DateTime struktúra új példányát a megadott évre, hónapra és napra.
DateTime(Int64, DateTimeKind)	Inicializálja a DateTime struktúra új példányát egy megadott számú kullancsra, valamint az egyezményes világidőre (UTC) vagy helyi időre.
DateTime(Int64)	Inicializálja a DateTime struktúra új példányát egy megadott számú kullancsra.

Mezők

Name	Description
MaxValue	A legnagyobb lehetséges értéket DateTimejelöli. Ez a mező csak olvasható.
MinValue	A lehető legkisebb értéket DateTimejelöli. Ez a mező csak olvasható.
UnixEpoch	Ennek az állandónak az értéke 1970. január 1-jének 00:00:00.0000000 UTC-nek felel meg a Gergely-naptárban. UnixEpoch Azt az időpontot határozza meg, amikor a Unix-idő 0-nak felel meg.

Tulajdonságok

Name	Description
Date	Lekéri a példány dátumösszetevőjét.
Day	Lekéri a példány által képviselt hónap napját.
DayOfWeek	Lekéri a jelen példány által képviselt hét napját.
DayOfYear	Lekéri az adott példány által képviselt év napját.
Hour	Megadja a példány által megjelenített dátum órakomponensét.
Kind	Olyan értéket kap, amely jelzi, hogy a példány által képviselt idő a helyi idő, az egyezményes világidő (UTC) vagy egyik sem alapján van-e megadva.
Millisecond	Lekéri a példány által képviselt dátum ezredmásodperc összetevőjét.
Minute	Megadja annak az időpontnak a percértékét, amelyet ez a példány képvisel.
Month	Lekéri a példány által képviselt dátum hónap összetevőjét.
Now	DateTime Lekéri a számítógépen az aktuális dátumra és időpontra beállított objektumot helyi időként kifejezve.
Second	Lekéri az adott példány által képviselt dátum másodperceit.
Ticks	Lekéri a példány dátumát és idejét ábrázoló kullancsok számát.
TimeOfDay	Lekéri a példány napjának idejét.
Today	Lekéri az aktuális dátumot.
UtcNow	DateTime Lekéri a számítógépen az aktuális dátumra és időpontra beállított objektumot, amely az egyezményes világidő (UTC) szerint van kifejezve.
Year	Lekéri az év komponensét a példány által reprezentált dátumból.

Metódusok

Name	Description
Add(TimeSpan)	Egy új DateTime értéket ad vissza, amely hozzáadja a megadott TimeSpan értéket a példány értékéhez.
AddDays(Double)	Egy új DateTime értéket ad vissza, amely hozzáadja a megadott számú napot a példány értékéhez.
AddHours(Double)	Egy újat DateTime ad vissza, amely hozzáadja a megadott számú órát a példány értékéhez.
AddMilliseconds(Double)	Egy új DateTime értéket ad vissza, amely hozzáadja a megadott számú ezredmásodpercet a példány értékéhez.
AddMinutes(Double)	Egy újat DateTime ad vissza, amely hozzáadja a megadott számú percet a példány értékéhez.
AddMonths(Int32)	Egy újat DateTime ad vissza, amely hozzáadja a megadott számú hónapot a példány értékéhez.
AddSeconds(Double)	Egy új DateTime értéket ad vissza, amely hozzáadja a megadott számú másodpercet a példány értékéhez.
AddTicks(Int64)	Egy új DateTime értéket ad vissza, amely hozzáadja a megadott számú kullancsot a példány értékéhez.
AddYears(Int32)	Egy új DateTime értéket ad vissza, amely hozzáadja a megadott számú évet a példány értékéhez.
Compare(DateTime, DateTime)	Összehasonlítja a két példányt DateTime , és egy egész számot ad vissza, amely jelzi, hogy az első példány korábbi-e, ugyanaz-e, mint a második példány, vagy később, mint a második példány.
CompareTo(DateTime)	Összehasonlítja a példány értékét egy megadott DateTime értékkel, és egy egész számot ad vissza, amely jelzi, hogy ez a példány a megadott DateTime értéknél korábbi, azonos vagy későbbi-e.
CompareTo(Object)	Összehasonlítja a példány értékét egy megadott DateTime értéket tartalmazó objektummal, és egy egész számot ad vissza, amely jelzi, hogy ez a példány a megadott DateTime értéknél korábbi, azonos vagy későbbi-e.
DaysInMonth(Int32, Int32)	A megadott hónap és év napjainak számát adja eredményül.
Equals(DateTime, DateTime)	Egy értéket ad vissza, amely azt jelzi, hogy két DateTime példány ugyanazzal a dátum- és időértékel rendelkezik-e.
Equals(DateTime)	Egy értéket ad vissza, amely jelzi, hogy a példány értéke megegyezik-e a megadott DateTime példány értékével.
Equals(Object)	Egy értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal.
FromBinary(Int64)	Deszerializál egy 64 bites bináris értéket, és újra létrehozza az eredeti szerializált DateTime objektumot.
FromFileTime(Int64)	A megadott Windows fájlidőt egyenértékű helyi idővé alakítja.
FromFileTimeUtc(Int64)	A megadott Windows fájlidőt egyenértékű UTC-idővé alakítja.
FromOADate(Double)	DateTime A megadott OLE Automation-dátummal egyenértékű értéket ad vissza.
GetDateTimeFormats()	A példány értékét a standard dátum- és időformátum-meghatározók által támogatott összes sztring-ábrázolássá alakítja át.
GetDateTimeFormats(Char, IFormatProvider)	A példány értékét konvertálja a megadott szabványos dátum- és időformátum-meghatározó által támogatott összes sztring-ábrázolásra, valamint a kultúraspecifikus formázási információkra.
GetDateTimeFormats(Char)	A példány értékét a megadott szabványos dátum- és időformátum-meghatározó által támogatott összes sztring-ábrázolássá alakítja át.
GetDateTimeFormats(IFormatProvider)	A példány értékét konvertálja a szabványos dátum- és időformátum-meghatározók által támogatott összes sztringre, valamint a megadott kultúraspecifikus formázási információkra.
GetHashCode()	A példány kivonatkódját adja vissza.
GetTypeCode()	TypeCode Az értéktípus DateTimeértékét adja vissza.
IsDaylightSavingTime()	Azt jelzi, hogy ez a DateTime példány a nyári időszámítási időtartományon belül van-e az aktuális időzónában.
IsLeapYear(Int32)	Azt jelzi, hogy a megadott év szökőév-e.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Olyan memóriatartományt alakít át, amely egy dátum és idő sztring-ábrázolását tartalmazza a DateTime megfelelőre a kultúraspecifikus formázási információk és formázási stílusok használatával.
Parse(String, IFormatProvider, DateTimeStyles)	Egy dátum és idő sztringképét átalakítja annak DateTime megfelelőjeként a kultúraspecifikus formátuminformációk és formázási stílusok használatával.
Parse(String, IFormatProvider)	Egy dátum és idő sztring-ábrázolását átalakítja annak DateTime megfelelővé kultúraspecifikus formátuminformációk használatával.
Parse(String)	Egy dátum és idő DateTime sztringképét az aktuális kultúra konvencióinak használatával konvertálja annak megfelelővé.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Egy dátum és idő megadott span-ábrázolását a megadott formátum, kultúraspecifikus formátumadatok és stílus használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátummal, vagy kivételt kell eredményeznie.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	Egy dátum és idő megadott span-ábrázolását a megadott formátumok, kultúraspecifikus formátumadatok és stílus használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátumok legalább egyikével, vagy kivételt kell eredményeznie.
ParseExact(String, String, IFormatProvider, DateTimeStyles)	Egy dátum és idő megadott sztringképét a megadott formátum, kultúraspecifikus formátumadatok és stílus használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátummal, vagy kivételt kell eredményeznie.
ParseExact(String, String, IFormatProvider)	Egy dátum és idő megadott sztring-ábrázolását a megadott formátum- és kultúraspecifikus formátumadatok használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátummal.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	Egy dátum és idő megadott sztring-ábrázolását a megadott formátumok, kultúraspecifikus formátumadatok és stílus használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátumok legalább egyikével, vagy kivételt kell eredményeznie.
SpecifyKind(DateTime, DateTimeKind)	Létrehoz egy új DateTime objektumot, amely a megadott DateTimeértékkel azonos számú kullancsot tartalmaz, de helyi időként, koordinált egyetemes időként (UTC) van kijelölve, vagy egyik sem, a megadott DateTimeKind értéknek megfelelően.
Subtract(DateTime)	Egy újat TimeSpan ad vissza, amely kivonja a megadott dátumot és időt a példány értékéből.
Subtract(TimeSpan)	Egy újat DateTime ad vissza, amely kivonja a megadott időtartamot a példány értékéből.
ToBinary()	Szerializálja az aktuális DateTime objektumot egy 64 bites bináris értékre, amely később felhasználható az DateTime objektum újbóli létrehozásához.
ToFileTime()	Az aktuális DateTime objektum értékét Windows fájlidővé alakítja.
ToFileTimeUtc()	Az aktuális DateTime objektum értékét Windows fájlidővé alakítja.
ToLocalTime()	Az aktuális DateTime objektum értékét helyi időre konvertálja.
ToLongDateString()	Az aktuális DateTime objektum értékét az azzal egyenértékű hosszú dátumú sztring-ábrázolássá alakítja.
ToLongTimeString()	Az aktuális DateTime objektum értékét az azzal egyenértékű hosszú idejű sztring-ábrázolássá alakítja át.
ToOADate()	A példány értékét az egyenértékű OLE Automation-dátummá alakítja.
ToShortDateString()	Az aktuális DateTime objektum értékét az azzal egyenértékű rövid dátumú sztringre konvertálja.
ToShortTimeString()	Az aktuális DateTime objektum értékét az azzal egyenértékű rövid idejű sztring-ábrázolássá alakítja.
ToString()	Az aktuális objektum értékét az aktuális DateTime kultúra formázási konvencióinak használatával konvertálja az azzal egyenértékű sztringre.
ToString(IFormatProvider)	Az aktuális DateTime objektum értékét a megadott kultúraspecifikus formátumadatok használatával konvertálja az azzal egyenértékű sztringre.
ToString(String, IFormatProvider)	Az aktuális DateTime objektum értékét a megadott formátum- és kultúraspecifikus formátumadatok használatával konvertálja az azzal egyenértékű sztringre.
ToString(String)	Az aktuális DateTime objektum értékét a megadott formátum és az aktuális kultúra formázási konvenciói alapján konvertálja a megfelelő sztringre.
ToUniversalTime()	Az aktuális DateTime objektum értékét koordinált univerzális idő (UTC) értékké alakítja.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Megpróbálja formázni az aktuális datetime-példány értékét a megadott karaktertartományba.
TryParse(ReadOnlySpan<Char>, DateTime)	Egy dátum és idő megadott karaktertartományát a megfelelő értékké DateTime alakítja, és egy értéket ad vissza, amely jelzi, hogy az átalakítás sikeres volt-e.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	A megadott kultúraspecifikus formátumadatok és formázási stílus használatával konvertálja egy dátum és idő DateTime span ábrázolását annak megfelelőjeként, és visszaad egy értéket, amely jelzi, hogy az átalakítás sikeres volt-e.
TryParse(String, DateTime)	Egy dátum és idő megadott sztringképét konvertálja annak DateTime megfelelőjeként, és visszaad egy értéket, amely jelzi, hogy az átalakítás sikeres volt-e.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	Egy dátum és idő megadott sztringképét a megadott kultúraspecifikus formátumadatok és formázási stílus használatával konvertálja DateTime annak megfelelőjeként, és visszaad egy értéket, amely jelzi, hogy az átalakítás sikeres volt-e.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Egy dátum és idő megadott span-ábrázolását a megadott formátum, kultúraspecifikus formátumadatok és stílus használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátummal. A metódus egy értéket ad vissza, amely jelzi, hogy az átalakítás sikeres volt-e.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)	Egy dátum és idő megadott karaktertartományát a megfelelő értékké DateTime alakítja, és egy értéket ad vissza, amely jelzi, hogy az átalakítás sikeres volt-e.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	Egy dátum és idő megadott sztringképét a megadott formátum, kultúraspecifikus formátumadatok és stílus használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátummal. A metódus egy értéket ad vissza, amely jelzi, hogy az átalakítás sikeres volt-e.
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	Egy dátum és idő megadott sztring-ábrázolását a megadott formátumok, kultúraspecifikus formátumadatok és stílus használatával konvertálja DateTime annak megfelelővé. A sztring-ábrázolás formátumának pontosan meg kell egyeznie a megadott formátumok legalább egyikével. A metódus egy értéket ad vissza, amely jelzi, hogy az átalakítás sikeres volt-e.

Operátorok

Name	Description
Addition(DateTime, TimeSpan)	Megadott időintervallumot ad hozzá egy megadott dátumhoz és időponthoz, új dátumot és időpontot eredményezve.
Equality(DateTime, DateTime)	Meghatározza, hogy két megadott példány DateTime egyenlő-e.
GreaterThan(DateTime, DateTime)	Meghatározza, hogy az egyik megadott DateTime későbbi-e, mint egy másik megadott DateTime.
GreaterThanOrEqual(DateTime, DateTime)	Meghatározza, hogy egy megadott DateTime dátum és idő megegyezik-e egy másik megadott dátummal vagy időpontmal DateTime.
Inequality(DateTime, DateTime)	Meghatározza, hogy két megadott példány DateTime nem egyenlő-e.
LessThan(DateTime, DateTime)	Meghatározza, hogy az egyik megadott DateTime korábbi-e, mint egy másik megadott DateTime.
LessThanOrEqual(DateTime, DateTime)	Meghatározza, hogy egy megadott DateTime dátum és idő megegyezik-e egy másik megadott dátummal vagy időpontmal DateTime.
Subtraction(DateTime, DateTime)	Kivon egy megadott dátumot és időt egy másik megadott dátumból és időből, és egy időintervallumot ad vissza.
Subtraction(DateTime, TimeSpan)	Kivon egy megadott időintervallumot egy megadott dátumból és időből, és egy új dátumot és időpontot ad vissza.

Explicit interfész-implementációk

Name	Description
IComparable.CompareTo(Object)	Összehasonlítja az aktuális példányt egy másik, azonos típusú objektummal, és egy egész számot ad vissza, amely azt jelzi, hogy az aktuális példány megelőzi, követi vagy ugyanabban a sorrendben fordul elő, mint a másik objektum.
IConvertible.GetTypeCode()	TypeCode A példány értékét adja vissza.
IConvertible.ToBoolean(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToByte(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToChar(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)	Az aktuális DateTime objektumot adja vissza.
IConvertible.ToDecimal(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToDouble(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToInt16(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToInt32(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToInt64(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToSByte(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToSingle(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)	Az aktuális DateTime objektumot egy megadott típusú objektummá alakítja.
IConvertible.ToUInt16(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)	Ez az átalakítás nem támogatott. A metódus használatának megkísérlése egy InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Feltölt egy SerializationInfo objektumot az aktuális DateTime objektum szerializálásához szükséges adatokkal.

A következőre érvényes:

Szálbiztonság

Az ilyen típusú tagok szálbiztosak. Azok a tagok, amelyek úgy tűnik, hogy módosítják a példány állapotát, valójában egy új példányt ad vissza, amely inicializálva van az új értékkel. Mint minden más típus esetén, az ilyen típusú példányt tartalmazó megosztott változókra való olvasást és írást zárolással kell védeni a szálbiztonság érdekében.

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?