DateTime Struktura

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

DateTime.cs

Představuje okamžik v čase, obvykle vyjádřený jako datum a čas dne.

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 IUtf8SpanFormattable
    interface ISerializable

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

Dědičnost

Object

ValueType

DateTime

Implementuje

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

Poznámky

Další informace o tomto rozhraní API naleznete v tématu Doplňkové poznámky k rozhraní API pro DateTime.

Konstruktory

Name	Description
DateTime(DateOnly, TimeOnly, DateTimeKind)	Inicializuje novou instanci DateTime struktury na zadanou DateOnly a TimeOnly respektující zadanou DateTimeKind.
DateTime(DateOnly, TimeOnly)	Inicializuje novou instanci DateTime struktury na zadaný DateOnly a TimeOnly. Nová instance bude mít druh Unspecified .
DateTime(Int32, Int32, Int32, Calendar)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc a den pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu a sekundu pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu a koordinovaný univerzální čas (UTC) nebo místní čas.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu, milisekundu a koordinovaný univerzální čas (UTC) nebo místní čas pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu a milisekundu pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu, milisekundu a koordinovaný univerzální čas (UTC) nebo místní čas.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu, milisekundu a koordinovaný univerzální čas (UTC) nebo místní čas pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu, milisekundu a koordinovaný univerzální čas (UTC) nebo místní čas pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu, milisekundu a koordinovaný univerzální čas (UTC) nebo místní čas pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu, milisekundu a koordinovaný univerzální čas (UTC) nebo místní čas pro zadaný kalendář.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu, sekundu a milisekundu.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc, den, hodinu, minutu a sekundu.
DateTime(Int32, Int32, Int32)	Inicializuje novou instanci DateTime struktury na zadaný rok, měsíc a den.
DateTime(Int64, DateTimeKind)	Inicializuje novou instanci struktury na zadaný počet záškrtů a do koordinovaného univerzálního DateTime času (UTC) nebo místního času.
DateTime(Int64)	Inicializuje novou instanci DateTime struktury na zadaný počet záškrtů.

Pole

Name	Description
MaxValue	Představuje největší možnou DateTimehodnotu . Toto pole je určeno pouze ke čtení.
MinValue	Představuje nejmenší možnou DateTimehodnotu . Toto pole je určeno pouze ke čtení.
UnixEpoch	Hodnota této konstanty odpovídá 00:00:00,00,0000000 UTC, 1. ledna 1970, v gregoriánském kalendáři. UnixEpoch definuje bod v čase, kdy se unixový čas rovná 0.

Vlastnosti

Name	Description
Date	Získá datovou komponentu této instance.
Day	Získá den v měsíci reprezentovaný touto instancí.
DayOfWeek	Získá den v týdnu reprezentovaný touto instancí.
DayOfYear	Získá den roku reprezentovaný touto instancí.
Hour	Získá hodinovou komponentu data reprezentované touto instancí.
Kind	Získá hodnotu, která určuje, zda čas reprezentovaný touto instancí je založen na místním čase, koordinovaném univerzálním čase (UTC) nebo ani na jednom.
Microsecond	Komponenta mikrosekund vyjádřená jako hodnota mezi 0 a 999.
Millisecond	Získá komponentu milisekund data reprezentované touto instancí.
Minute	Získá minutovou komponentu data reprezentované touto instancí.
Month	Získá měsíc součást data reprezentované touto instancí.
Nanosecond	Komponenta nanosekund vyjádřená jako hodnota mezi 0 a 900 (v přírůstcích po 100 nanosekundách).
Now	DateTime Získá objekt, který je nastaven na aktuální datum a čas v tomto počítači vyjádřeno jako místní čas.
Second	Získá sekundu součásti data reprezentované touto instancí.
Ticks	Získá počet záškrtů, které představují datum a čas této instance.
TimeOfDay	Získá čas dne pro tuto instanci.
Today	Získá aktuální datum.
UtcNow	DateTime Získá objekt, který je nastaven na aktuální datum a čas v tomto počítači, vyjádřený jako koordinovaný univerzální čas (UTC).
Year	Získá rok součást data reprezentované touto instancí.

Metody

Name	Description
Add(TimeSpan)	Vrátí novou DateTime hodnotu, která přidá hodnotu zadanou TimeSpan k hodnotě této instance.
AddDays(Double)	Vrátí novou DateTime hodnotu, která k hodnotě této instance přičte zadaný počet dní.
AddHours(Double)	Vrátí novou DateTime hodnotu, která k hodnotě této instance přidá zadaný počet hodin.
AddMicroseconds(Double)	Vrátí novou DateTime hodnotu, která k hodnotě této instance přidá zadaný počet mikrosekund.
AddMilliseconds(Double)	Vrátí novou DateTime hodnotu, která přidá zadaný počet milisekund k hodnotě této instance.
AddMinutes(Double)	Vrátí novou DateTime hodnotu, která k hodnotě této instance přidá zadaný počet minut.
AddMonths(Int32)	Vrátí novou DateTime hodnotu, která k hodnotě této instance přičte zadaný počet měsíců.
AddSeconds(Double)	Vrátí novou DateTime hodnotu, která k hodnotě této instance přidá zadaný počet sekund.
AddTicks(Int64)	Vrátí novou DateTime hodnotu, která přidá zadaný počet záškrtů k hodnotě této instance.
AddYears(Int32)	Vrátí novou DateTime hodnotu, která k hodnotě této instance přičte zadaný počet roků.
Compare(DateTime, DateTime)	Porovná dvě instance DateTime a vrátí celé číslo, které určuje, jestli je první instance starší než, stejná jako nebo novější než druhá instance.
CompareTo(DateTime)	Porovná hodnotu této instance se zadanou DateTime hodnotou a vrátí celé číslo, které určuje, zda je tato instance dřívější než, stejná nebo pozdější než zadaná DateTime hodnota.
CompareTo(Object)	Porovná hodnotu této instance se zadaným objektem, který obsahuje zadanou DateTime hodnotu, a vrátí celé číslo, které určuje, zda je tato instance dřívější, stejná nebo pozdější než zadaná DateTime hodnota.
DaysInMonth(Int32, Int32)	Vrátí počet dní v zadaném měsíci a roce.
Deconstruct(DateOnly, TimeOnly)	Dekonstrukce této DateTime instance pomocí DateOnly a TimeOnly.
Deconstruct(Int32, Int32, Int32)	Dekonstrukce této DateOnly instance pomocí Year, Montha Day.
Equals(DateTime, DateTime)	Vrátí hodnotu určující, zda mají dvě DateTime instance stejnou hodnotu data a času.
Equals(DateTime)	Vrátí hodnotu určující, zda je hodnota této instance rovna hodnotě zadané DateTime instance.
Equals(Object)	Vrátí hodnotu určující, zda je tato instance rovna zadanému objektu.
FromBinary(Int64)	Deserializuje 64bitovou binární hodnotu a znovu vytvoří původní serializovaný DateTime objekt.
FromFileTime(Int64)	Převede zadaný čas souboru Systému Windows na ekvivalentní místní čas.
FromFileTimeUtc(Int64)	Převede zadaný čas souboru Systému Windows na ekvivalentní čas UTC.
FromOADate(Double)	DateTime Vrátí ekvivalent zadaného data automatizace OLE.
GetDateTimeFormats()	Převede hodnotu této instance na všechny řetězcové reprezentace podporované standardními specifikátory formátu data a času.
GetDateTimeFormats(Char, IFormatProvider)	Převede hodnotu této instance na všechny řetězcové reprezentace podporované specifikátorem standardního formátu data a času a informacemi o formátování specifické pro jazykovou verzi.
GetDateTimeFormats(Char)	Převede hodnotu této instance na všechny řetězcové reprezentace podporované specifikátorem zadaného standardního formátu data a času.
GetDateTimeFormats(IFormatProvider)	Převede hodnotu této instance na všechny řetězcové reprezentace podporované standardními specifikátory formátu data a času a určenými informacemi o formátování specifické pro jazykovou verzi.
GetHashCode()	Vrátí kód hash pro tuto instanci.
GetTypeCode()	TypeCode Vrátí hodnotu pro typ DateTimehodnoty .
IsDaylightSavingTime()	Určuje, zda je tato instance DateTime v letním časovém rozsahu aktuálního časového pásma.
IsLeapYear(Int32)	Vrátí indikaci, zda je zadaný rok přestupným rokem.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Převede rozsah paměti, který obsahuje řetězcové vyjádření data a času, na jeho DateTime ekvivalent pomocí informací o formátu specifickém pro jazykovou verzi a stylu formátování.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Parsuje rozsah znaků do hodnoty.
Parse(String, IFormatProvider, DateTimeStyles)	Převede řetězcovou reprezentaci data a času na jeho DateTime ekvivalent pomocí informací o formátu specifické pro jazykovou verzi a stylu formátování.
Parse(String, IFormatProvider)	Převede řetězcovou reprezentaci data a času na ekvivalent DateTime pomocí informací o formátu specifickém pro jazykovou verzi.
Parse(String)	Převede řetězcové vyjádření data a času na jeho DateTime ekvivalent pomocí konvencí aktuální jazykové verze.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Převede zadanou reprezentaci data a času na ekvivalent DateTime pomocí zadaného formátu, informací o formátu specifickém pro jazykovou verzi a stylu. Formát řetězcové reprezentace se musí přesně shodovat se zadaným formátem nebo je vyvolán výjimka.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	Převede zadanou reprezentaci data a času na DateTime ekvivalent pomocí zadaného pole formátů, informací o formátu specifickém pro jazykovou verzi a stylu. Formát řetězcové reprezentace se musí shodovat s alespoň jedním ze zadaných formátů přesně nebo je vyvolán výjimka.
ParseExact(String, String, IFormatProvider, DateTimeStyles)	Převede zadanou řetězcovou reprezentaci data a času na ekvivalent DateTime pomocí zadaného formátu, informací o formátu specifickém pro jazykovou verzi a stylu. Formát řetězcové reprezentace se musí přesně shodovat se zadaným formátem nebo je vyvolán výjimka.
ParseExact(String, String, IFormatProvider)	Převede zadanou řetězcovou reprezentaci data a času na ekvivalent DateTime pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi. Formát řetězcové reprezentace se musí přesně shodovat se zadaným formátem.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	Převede zadanou řetězcovou reprezentaci data a času na ekvivalent DateTime pomocí zadaného pole formátů, informací o formátu specifickém pro jazyk a styl. Formát řetězcové reprezentace se musí shodovat s alespoň jedním ze zadaných formátů přesně nebo je vyvolán výjimka.
SpecifyKind(DateTime, DateTimeKind)	Vytvoří nový DateTime objekt, který má stejný počet záškrtů jako zadaný DateTime, ale je určen buď jako místní čas, koordinovaný univerzální čas (UTC), nebo ani jeden, jak je uvedeno zadanou DateTimeKind hodnotou.
Subtract(DateTime)	Vrátí novou TimeSpan hodnotu, která odečte zadané datum a čas od hodnoty této instance.
Subtract(TimeSpan)	Vrátí novou DateTime hodnotu, která odečte zadanou dobu trvání od hodnoty této instance.
ToBinary()	Serializuje aktuální DateTime objekt na 64bitovou binární hodnotu, kterou lze následně použít k opětovnému vytvoření objektu DateTime .
ToFileTime()	Převede hodnotu aktuálního DateTime objektu na čas souboru systému Windows.
ToFileTimeUtc()	Převede hodnotu aktuálního DateTime objektu na čas souboru systému Windows.
ToLocalTime()	Převede hodnotu aktuálního DateTime objektu na místní čas.
ToLongDateString()	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření dlouhého data.
ToLongTimeString()	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření dlouhého času.
ToOADate()	Převede hodnotu této instance na ekvivalentní datum automatizace OLE.
ToShortDateString()	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření krátkého data.
ToShortTimeString()	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření krátkého času.
ToString()	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření pomocí konvencí formátování aktuální jazykové verze.
ToString(IFormatProvider)	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření pomocí zadaných informací o formátu specifické pro jazykovou verzi.
ToString(String, IFormatProvider)	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi.
ToString(String)	Převede hodnotu aktuálního DateTime objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu a konvencí formátování aktuální jazykové verze.
ToUniversalTime()	Převede hodnotu aktuálního DateTime objektu na koordinovaný univerzální čas (UTC).
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Pokusí se naformátovat hodnotu aktuální instance jako UTF-8 do poskytnutého rozsahu bajtů.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Pokusí se naformátovat hodnotu aktuální instance datetime do zadaného rozsahu znaků.
TryParse(ReadOnlySpan<Char>, DateTime)	Převede zadané rozsahy znaků data a času na jeho DateTime ekvivalent a vrátí hodnotu, která označuje, zda převod proběhl úspěšně.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)	Pokusí se analyzovat rozsah znaků do hodnoty.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Převede reprezentaci rozsahu data a času na jeho DateTime ekvivalent pomocí zadaných informací o formátu specifické pro jazykovou verzi a stylu formátování a vrátí hodnotu, která označuje, zda převod proběhl úspěšně.
TryParse(String, DateTime)	Převede zadanou řetězcovou reprezentaci data a času na jeho DateTime ekvivalent a vrátí hodnotu, která označuje, zda převod proběhl úspěšně.
TryParse(String, IFormatProvider, DateTime)	Pokusí se analyzovat řetězec do hodnoty.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	Převede zadanou řetězcovou reprezentaci data a času na ekvivalent DateTime pomocí zadaných informací o formátu specifickém pro jazykovou verzi a stylu formátování a vrátí hodnotu, která určuje, zda převod proběhl úspěšně.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Převede zadanou reprezentaci data a času na ekvivalent DateTime pomocí zadaného formátu, informací o formátu specifickém pro jazykovou verzi a stylu. Formát řetězcové reprezentace se musí přesně shodovat se zadaným formátem. Metoda vrátí hodnotu, která označuje, zda převod byl úspěšný.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)	Převede zadané rozsahy znaků data a času na jeho DateTime ekvivalent a vrátí hodnotu, která označuje, zda převod proběhl úspěšně.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	Převede zadanou řetězcovou reprezentaci data a času na ekvivalent DateTime pomocí zadaného formátu, informací o formátu specifickém pro jazykovou verzi a stylu. Formát řetězcové reprezentace se musí přesně shodovat se zadaným formátem. Metoda vrátí hodnotu, která označuje, zda převod byl úspěšný.
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	Převede zadanou řetězcovou reprezentaci data a času na ekvivalent DateTime pomocí zadaného pole formátů, informací o formátu specifickém pro jazyk a styl. Formát řetězcové reprezentace musí přesně odpovídat jednomu ze zadaných formátů. Metoda vrátí hodnotu, která označuje, zda převod byl úspěšný.

Operátory

Name	Description
Addition(DateTime, TimeSpan)	Přidá zadaný časový interval k zadanému datu a času a získá nové datum a čas.
Equality(DateTime, DateTime)	Určuje, zda jsou dvě zadané instance DateTime stejné.
GreaterThan(DateTime, DateTime)	Určuje, zda je zadaná DateTime hodnota pozdější než jiná zadaná DateTime.
GreaterThanOrEqual(DateTime, DateTime)	Určuje, zda jeden zadaný DateTime představuje datum a čas, který je stejný jako nebo pozdější než jiný zadaný DateTime.
Inequality(DateTime, DateTime)	Určuje, zda se dvě zadané instance DateTime nerovnají.
LessThan(DateTime, DateTime)	Určuje, zda je zadaná DateTime hodnota dřívější než jiná zadaná DateTime.
LessThanOrEqual(DateTime, DateTime)	Určuje, zda jeden zadaný DateTime představuje datum a čas, který je stejný jako nebo dřívější než jiný zadaný DateTime.
Subtraction(DateTime, DateTime)	Odečte zadané datum a čas od jiného zadaného data a času a vrátí časový interval.
Subtraction(DateTime, TimeSpan)	Odečte zadaný časový interval od zadaného data a času a vrátí nové datum a čas.

Explicitní implementace rozhraní

Name	Description
IConvertible.ToBoolean(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToByte(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToChar(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)	Vrátí aktuální DateTime objekt.
IConvertible.ToDecimal(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToDouble(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToInt16(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToInt32(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToInt64(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToSByte(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToSingle(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)	Převede aktuální DateTime objekt na objekt zadaného typu.
IConvertible.ToUInt16(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)	Tento převod není podporován. Pokus o použití této metody vyvolá výjimku InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Naplní SerializationInfo objekt daty potřebnými k serializaci aktuálního DateTime objektu.

Bezpečný přístup z více vláken

Všichni členové tohoto typu jsou bezpečné pro přístup z více vláken. Členové, kteří se zdá, že upravují stav instance, ve skutečnosti vrátí novou instanci inicializovanou s novou hodnotou. Stejně jako u jakéhokoli jiného typu musí být čtení a zápis do sdílené proměnné, která obsahuje instanci tohoto typu, chráněn zámkem, aby se zajistilo zabezpečení vlákna.

Viz také

• DateTimeOffset
• TimeSpan
• Calendar
• GetUtcOffset(DateTime)
• TimeZoneInfo
• Volba mezi DateTime, DateTimeOffset, TimeSpan a TimeZoneInfo
• Práce s kalendáři
• Ukázka : rozhraní .NET Core WinForms (C#)
• ukázka : .NET Core WinForms Formatting Utility (Visual Basic)