DateTime Структура

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Исходный код:

DateTime.cs

Представляет текущее время, обычно выраженное как дата и время суток.

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

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

Наследование

Object

ValueType

DateTime

Реализации

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

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для DateTime.

Конструкторы

DateTime(DateOnly, TimeOnly)	Инициализирует новый экземпляр DateTime структуры заданными DateOnly и TimeOnly. Новый экземпляр будет иметь Unspecified тип .
DateTime(DateOnly, TimeOnly, DateTimeKind)	Инициализирует новый экземпляр DateTime структуры указанным DateOnly и TimeOnly с учетом указанного DateTimeKind.
DateTime(Int32, Int32, Int32)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца и дня.
DateTime(Int32, Int32, Int32, Calendar)	Инициализирует новый экземпляр структуры DateTime заданным годом, месяцем и днем для указанного календаря.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	Инициализирует новый экземпляр структуры DateTime заданным годом, месяцем, днем, часом, минутой и секундой.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Инициализирует новый экземпляр структуры DateTime указанным годом, месяцем, днем, часом, минутой и секундой для заданного календаря.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца, дня, часа, минуты и секунды, а также временем UTC или местным временем.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Инициализирует новый экземпляр структуры DateTime заданным годом, месяцем, днем, часом, минутой, секундой и миллисекундой.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Инициализирует новый экземпляр структуры DateTime указанным годом, месяцем, днем, часом, минутой, секундой и миллисекундой для заданного календаря.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца, дня, часа, минуты, секунды и миллисекунды, а также временем UTC или местным временем для заданного календаря.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца, дня, часа, минуты, секунды и миллисекунды, а также временем UTC или местным временем.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца, дня, часа, минуты, секунды и миллисекунды, а также временем UTC или местным временем для заданного календаря.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца, дня, часа, минуты, секунды и миллисекунды, а также временем UTC или местным временем для заданного календаря.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца, дня, часа, минуты, секунды и миллисекунды, а также временем UTC или местным временем для заданного календаря.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Инициализирует новый экземпляр структуры DateTime заданными значениями года, месяца, дня, часа, минуты, секунды и миллисекунды, а также временем UTC или местным временем для заданного календаря.
DateTime(Int64)	Инициализирует новый экземпляр структуры DateTime заданным числом тактов.
DateTime(Int64, DateTimeKind)	Инициализирует новый экземпляр структуры DateTime заданным числом тактов и временем UTC или местным временем.

Поля

MaxValue	Представляет наибольшее возможное значение типа DateTime. Это поле доступно только для чтения.
MinValue	Представляет минимально допустимое значение типа DateTime. Это поле доступно только для чтения.
UnixEpoch	Значение этой константы эквивалентно 00:00:00.0000000 UTC 1 января 1970 г. по григорианскому календарю. UnixEpoch определяет момент времени, в который значение времени в формате Unix равно 0.

Свойства

Date	Возвращает компоненту даты этого экземпляра.
Day	Возвращает день месяца, представленный этим экземпляром.
DayOfWeek	Возвращает день недели, представленный этим экземпляром.
DayOfYear	Возвращает день года, представленный этим экземпляром.
Hour	Возвращает компонент часа даты, представленной этим экземпляром.
Kind	Возвращает значение, указывающее, на каком времени основано время, представленное этим экземпляром: местном, UTC или ни на том, ни на другом.
Microsecond	Компонент микросекунд, выраженный как значение от 0 до 999.
Millisecond	Возвращает компонент миллисекунд для даты, представленной в данном экземпляре.
Minute	Возвращает компонент минуты даты, представленной этим экземпляром.
Month	Возвращает компонент месяца даты, представленной этим экземпляром.
Nanosecond	Компонент наносекунд, выраженный в виде значения от 0 до 900 (приращение 100 наносекунд).
Now	Возвращает объект DateTime, которому присвоены текущие дата и время данного компьютера, выраженные как местное время.
Second	Возвращает компонент секунды даты, представленной этим экземпляром.
Ticks	Возвращает число тактов, которое представляет дату и время этого экземпляра.
TimeOfDay	Возвращает время дня для этого экземпляра.
Today	Возвращает текущую дату.
UtcNow	Возвращает объект DateTime, которому присвоены текущие дата и время данного компьютера, выраженные в формате UTC.
Year	Возвращает компонент года даты, представленной этим экземпляром.

Методы

Add(TimeSpan)	Возвращает новый объект DateTime, добавляющий значение заданного объекта TimeSpan к значению данного экземпляра.
AddDays(Double)	Возвращает новый объект DateTime, добавляющий заданное число дней к значению данного экземпляра.
AddHours(Double)	Возвращает новый объект DateTime, добавляющий заданное число часов к значению данного экземпляра.
AddMicroseconds(Double)	Возвращает новый DateTime объект , который добавляет указанное число микросекунд к значению этого экземпляра.
AddMilliseconds(Double)	Возвращает новый объект DateTime, добавляющий заданное число миллисекунд к значению данного экземпляра.
AddMinutes(Double)	Возвращает новый объект DateTime, добавляющий заданное число минут к значению данного экземпляра.
AddMonths(Int32)	Возвращает новый объект DateTime, добавляющий заданное число месяцев к значению данного экземпляра.
AddSeconds(Double)	Возвращает новый объект DateTime, добавляющий заданное число секунд к значению данного экземпляра.
AddTicks(Int64)	Возвращает новый объект DateTime, добавляющий заданное число тактов к значению данного экземпляра.
AddYears(Int32)	Возвращает новый объект DateTime, добавляющий заданное число лет к значению данного экземпляра.
Compare(DateTime, DateTime)	Сравнивает два экземпляра объекта DateTime и возвращает целое число, которое показывает, предшествует ли первый экземпляр второму, совпадает или расположен позже.
CompareTo(DateTime)	Сравнивает значение данного экземпляра с заданным значением DateTime и возвращает целочисленное значение, указывающее, когда наступает момент, заданный в данном экземпляре: раньше, позже или одновременно с моментом, заданным значением DateTime.
CompareTo(Object)	Сравнивает значение данного экземпляра с заданным объектом, содержащим заданное значение DateTime, и возвращает целочисленное значение, указывающее, когда наступает момент, заданный в данном экземпляре: раньше, позже или одновременно с моментом, заданным значением DateTime.
DaysInMonth(Int32, Int32)	Возвращает число дней в указанном месяце указанного года.
Deconstruct(DateOnly, TimeOnly)	Деконструирует этот DateTime экземпляр с помощью DateOnly и TimeOnly.
Deconstruct(Int32, Int32, Int32)	Деконструирует этот DateOnly экземпляр с помощью Year, Monthи Day.
Equals(DateTime)	Возвращает значение, указывающее, равно ли значение данного экземпляра значению заданного экземпляра DateTime.
Equals(DateTime, DateTime)	Возвращает значение, указывающее, имеют ли два DateTime экземпляра одинаковые значения даты и времени.
Equals(Object)	Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.
FromBinary(Int64)	Десериализует 64-битовое значение и воссоздает исходный сериализованный объект DateTime.
FromFileTime(Int64)	Преобразует заданную временную характеристику файла Windows в ее эквивалент по местному времени.
FromFileTimeUtc(Int64)	Преобразует заданную временную характеристику файла Windows в ее UTC-эквивалент.
FromOADate(Double)	Возвращает объект DateTime, эквивалентный заданному значению даты OLE-автоматизации.
GetDateTimeFormats()	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые стандартным форматом даты и времени.
GetDateTimeFormats(Char)	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые указанным стандартным спецификатором формата даты и времени.
GetDateTimeFormats(Char, IFormatProvider)	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые указанным стандартным спецификатором формата даты и времени и сведениями о форматировании, связанными с языком и региональными параметрами.
GetDateTimeFormats(IFormatProvider)	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые стандартными спецификаторами формата даты и времени и указанными сведениями о форматировании, связанными с языком и региональными параметрами.
GetHashCode()	Возвращает хэш-код данного экземпляра.
GetTypeCode()	Возвращает TypeCode для типа значения DateTime.
IsDaylightSavingTime()	Указывает, попадает ли данный экземпляр объекта DateTime в диапазон летнего времени для текущего часового пояса.
IsLeapYear(Int32)	Возвращает сведения о том, является ли указанный год високосным.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Анализирует диапазон символов в значение.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Преобразует область памяти, которая содержит строковое представление даты и времени, в ее эквивалент DateTime, используя сведения о форматировании, связанные с языком и региональными параметрами, а также стиль форматирования.
Parse(String)	Преобразует строковое представление даты и времени в эквивалентные DateTime значения, используя соглашения текущего языка и региональных параметров.
Parse(String, IFormatProvider)	Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя сведения о форматировании, связанные с языком и региональными параметрами.
Parse(String, IFormatProvider, DateTimeStyles)	Преобразует строковое представление даты и времени в его эквивалент DateTime, используя сведения о форматировании, связанные с языком и региональными параметрами, а также стиль форматирования.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Преобразует заданное представление диапазона даты и времени в его эквивалент DateTime, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль. Формат строкового представления должен полностью соответствовать заданному формату. В противном случае возникает исключение.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	Преобразует заданное представление диапазона даты и времени в его эквивалент DateTime, используя заданный массив форматов, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль. Формат строкового представления должен полностью соответствовать по крайней мере одному из заданных форматов. В противном случае возникает исключение.
ParseExact(String, String, IFormatProvider)	Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя указанные сведения о форматировании, связанные с языком и региональными параметрами. Формат строкового представления должен полностью соответствовать заданному формату.
ParseExact(String, String, IFormatProvider, DateTimeStyles)	Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль. Формат строкового представления должен полностью соответствовать заданному формату. В противном случае возникает исключение.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя заданный массив форматов, указанные сведения о форматировании, связанные с языком и региональными параметрами, и стиль форматирования. Формат строкового представления должен полностью соответствовать по крайней мере одному из заданных форматов. В противном случае возникает исключение.
SpecifyKind(DateTime, DateTimeKind)	Создает новый объект DateTime, имеющий то же количество тактов, что и заданный объект DateTime, но предназначенный для использования либо с местным временем, стандартом UTC, либо ни тем, ни другим, как задано значением DateTimeKind.
Subtract(DateTime)	Возвращает новый объект TimeSpan, который вычитает из значения этого экземпляра указанную дату и время.
Subtract(TimeSpan)	Возвращает новый объект DateTime, который вычитает из значения этого экземпляра указанную длительность.
ToBinary()	Сериализует текущий объект DateTime в 64-разрядное двоичное значение, которое может использоваться в дальнейшем для воссоздания объекта DateTime.
ToFileTime()	Преобразует значение текущего объекта DateTime во временную характеристику файла Windows.
ToFileTimeUtc()	Преобразует значение текущего объекта DateTime во временную характеристику файла Windows.
ToLocalTime()	Преобразует значение текущего объекта DateTime в местное время.
ToLongDateString()	Преобразует значение текущего объекта DateTime в эквивалентное ему длинное строковое представление даты.
ToLongTimeString()	Преобразует значение текущего объекта DateTime в эквивалентное ему длинное строковое представление времени.
ToOADate()	Преобразует числовое значение этого экземпляра в эквивалентное ему значение даты OLE-автоматизации.
ToShortDateString()	Преобразует значение текущего объекта DateTime в эквивалентное ему короткое строковое представление даты.
ToShortTimeString()	Преобразует значение текущего объекта DateTime в эквивалентное ему короткое строковое представление времени.
ToString()	Преобразует значение текущего объекта DateTime в эквивалентное строковое представление с помощью соглашений о форматировании для текущего языка и региональных параметров.
ToString(IFormatProvider)	Преобразует значение текущего объекта DateTime в эквивалентное ему строковое представление с использованием указанных сведений о форматировании, связанных с языком и региональными параметрами.
ToString(String)	Преобразует значение текущего объекта DateTime в эквивалентное строковое представление с использованием указанного формата и соглашений о форматировании, принятых для текущего языка и региональных параметров.
ToString(String, IFormatProvider)	Преобразует значение текущего объекта DateTime в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для данного языка и региональных параметров.
ToUniversalTime()	Преобразует значение текущего объекта DateTime во время UTC.
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Пытается отформатировать значение текущего экземпляра как UTF-8 в предоставленный диапазон байтов.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Пытается отформатировать значение текущего экземпляра даты и времени в указанный диапазон символов.
TryParse(ReadOnlySpan<Char>, DateTime)	Преобразовывает указанный диапазон символов даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)	Пытается проанализировать диапазон символов в значение.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Преобразует представление даты и времени в виде диапазона в его эквивалент DateTime, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
TryParse(String, DateTime)	Преобразовывает указанное строковое представление даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.
TryParse(String, IFormatProvider, DateTime)	Пытается проанализировать строку в значение.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, и возвращает значение, которое показывает успешность преобразования.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Преобразует заданное представление диапазона даты и времени в его эквивалент DateTime, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль. Формат строкового представления должен полностью соответствовать заданному формату. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)	Преобразовывает указанный диапазон символов даты и времени в его эквивалент DateTime и возвращает значение, позволяющее определить успешность преобразования.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль. Формат строкового представления должен полностью соответствовать заданному формату. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	Преобразует заданное строковое представление даты и времени в его эквивалент DateTime, используя заданный массив форматов, указанные сведения о форматировании, связанные с языком и региональными параметрами, и стиль форматирования. Формат представления строки должен полностью соответствовать хотя бы одному заданному формату. Метод возвращает значение, указывающее, успешно ли выполнено преобразование.

Операторы

Addition(DateTime, TimeSpan)	Прибавляет указанный временной интервал к заданной дате и времени, возвращая новую дату и время.
Equality(DateTime, DateTime)	Определяет, равны ли два заданных экземпляра класса DateTime.
GreaterThan(DateTime, DateTime)	Определяет, является ли значение одного заданного объекта DateTime позже другого заданного объекта DateTime.
GreaterThanOrEqual(DateTime, DateTime)	Определяет, представляет ли один заданный DateTime дату и время, которое такое же или позже, чем другое заданное DateTime.
Inequality(DateTime, DateTime)	Определяет, являются ли два заданных экземпляра класса DateTime неравными.
LessThan(DateTime, DateTime)	Определяет, является ли значение одного заданного объекта DateTime раньшим, чем значение другого заданного объекта DateTime.
LessThanOrEqual(DateTime, DateTime)	Определяет, представляет ли один заданный DateTime дату и время, которое такое же или раньше, чем другое заданное DateTime.
Subtraction(DateTime, DateTime)	Вычитает указанную дату и время из другой указанной даты и времени и возвращает временной интервал.
Subtraction(DateTime, TimeSpan)	Вычитает заданный временной интервал из указанной даты и времени и возвращает новую дату и время.

Явные реализации интерфейса

IConvertible.ToBoolean(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToByte(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToChar(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)	Возвращает текущий объект DateTime.
IConvertible.ToDecimal(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToDouble(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToInt16(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToInt32(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToInt64(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToSByte(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToSingle(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)	Преобразует текущий объект DateTime в объект заданного типа.
IConvertible.ToUInt16(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)	Это преобразование не поддерживается. При попытке использовать этот метод выбрасывается исключение InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Заполняет объект SerializationInfo данными, необходимыми для сериализации текущего объекта DateTime.

Потокобезопасность

Все члены этого типа являются потокобезопасны. Члены, которые могут изменить состояние экземпляра, в действительности возвращают новый экземпляр, инициализированный новым значением. Как с любым другим типом, чтение и запись общей переменной, которая содержит экземпляр этого типа, должны быть защищены блокировкой для обеспечения потокобезопасности.

См. также раздел

• DateTimeOffset
• TimeSpan
• Calendar
• GetUtcOffset(DateTime)
• TimeZoneInfo
• Выбор между типами DateTime, DateTimeOffset, TimeSpan и TimeZoneInfo.
• Работа с календарями
• Пример: служебная программа форматирования .NET Core WinForms (C#)
• Пример: служебная программа форматирования .NET Core WinForms (Visual Basic)