DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset Struct

Определение

Представляет момент времени, который обычно выражается в виде даты и времени суток, относительно времени в формате UTC.Represents a point in time, typically expressed as a date and time of day, relative to Coordinated Universal Time (UTC).

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
[System.Serializable]
public struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type DateTimeOffset = struct
    interface IFormattable
    interface ISerializable
    interface IDeserializationCallback
Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IFormattable, ISerializable
Наследование
DateTimeOffsetDateTimeOffsetDateTimeOffsetDateTimeOffset
Атрибуты
Реализации

Комментарии

Структура включает DateTimeOffset значение вместе со свойством, которое определяет разницу между датой и временем текущего экземпляра и временем в формате UTC. Offset DateTimeOffset DateTimeThe DateTimeOffset structure includes a DateTime value, together with an Offset property that defines the difference between the current DateTimeOffset instance's date and time and Coordinated Universal Time (UTC). Поскольку он точно определяет дату и время относительно времени в формате UTC, DateTimeOffset структура не Kind включает член, как это DateTime делает структура.Because it exactly defines a date and time relative to UTC, the DateTimeOffset structure does not include a Kind member, as the DateTime structure does. Он представляет значения даты и времени со значениями, в которых диапазоны UTC — от 12:00:00 полночи 1 января 0001 г. Анно Домини (общая эра), 11:59:59 P.M., 31 декабря 9999 г. н. э.It represents dates and times with values whose UTC ranges from 12:00:00 midnight, January 1, 0001 Anno Domini (Common Era), to 11:59:59 P.M., December 31, 9999 A.D. (C.E.).(C.E.).

Важно!

Эры в японских календарях основаны на периодах царствования императоров. Таким образом, ожидается наступление новой эры.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Например, 1 мая 2019 года в JapaneseCalendar и JapaneseLunisolarCalendar отмечено как начало эры Рэйва.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Изменение эры затрагивает все приложения, использующие эти календари.Such a change of era affects all applications that use these calendars. Из раздела Обработка новой эры по японскому календарю в .NET можно почерпнуть дополнительные сведения, а также узнать, затронуты ли ваши приложения этим изменением.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Сведения о тестировании приложений в системах Windows для обеспечения их готовности к работе в новой эре см. в разделе Подготовка приложения к изменению эры по японскому календарю.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Сведения о функциях в .NET, которые поддерживают календарь с несколькими эрами, и рекомендации по использованию таких календарей см. в разделе о работе с эрами.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Компонент времени в DateTimeOffset значении измеряется в 100-наносекундных единицах, именуемых тактами, а конкретная дата — число тактов с 12:00 полуночи, 1 января 0001 г.The time component of a DateTimeOffset value is measured in 100-nanosecond units called ticks, and a particular date is the number of ticks since 12:00 midnight, January 1, 0001 A.D. эры GregorianCalendar в календаре.(C.E.) in the GregorianCalendar calendar. DateTimeOffset Значение всегда выражается в контексте явного или стандартного календаря.A DateTimeOffset value is always expressed in the context of an explicit or default calendar. Такты, которые могут быть назначены високосным секундам, не включаются в общее число тактов.Ticks that are attributable to leap seconds are not included in the total number of ticks.

DateTimeOffset Хотя значение включает смещение, это не полностью структура данных, учитывающая часовой пояс.Although a DateTimeOffset value includes an offset, it is not a fully time zone-aware data structure. Хотя смещение от времени в формате UTC является одной из характеристик часового пояса, оно не однозначно определяет часовой пояс.While an offset from UTC is one characteristic of a time zone, it does not unambiguously identify a time zone. Не только несколько часовых поясов имеют одинаковое смещение относительно времени в формате UTC, но смещение одного часового пояса меняется, если оно обнаруживает переход на летнее время.Not only do multiple time zones share the same offset from UTC, but the offset of a single time zone changes if it observes daylight saving time. Это означает, что, как только DateTimeOffset значение будет связано с часовым поясом, оно больше не сможет однозначно связать его с исходным часовым поясом.This means that, as soon as a DateTimeOffset value is disassociated from its time zone, it can no longer be unambiguously linked back to its original time zone.

Поскольку DateTimeOffset является структурой DateTimeOffset , объект, который был объявлен, но не инициализирован в противном случае, содержит значения по умолчанию для каждого из полей элементов.Because DateTimeOffset is a structure, a DateTimeOffset object that has been declared but not otherwise initialized contains the default values for each of its member fields. Это означает, что DateTime свойство имеет DateTimeOffset.MinValue значение, а TimeSpan.Zeroего Offset свойство имеет значение.This means that its DateTime property is set to DateTimeOffset.MinValue and its Offset property is set to TimeSpan.Zero.

Можно создать новое DateTimeOffset значение, вызвав любую из перегрузок своего конструктора, которые похожи на перегруженные конструкторы DateTime для структуры.You can create a new DateTimeOffset value by calling any of the overloads of its constructor, which are similar to the overloaded constructors for the DateTime structure. Можно также создать новое DateTimeOffset значение, назначив DateTime ему значение.You can also create a new DateTimeOffset value by assigning it a DateTime value. Это неявное преобразование; Он не требует оператора приведения (in C#) или вызова метода преобразования (в Visual Basic).This is an implicit conversion; it does not require a casting operator (in C#) or call to a conversion method (in Visual Basic). DateTimeOffset Можно также инициализировать значение из строкового представления даты и времени, вызвав несколько методов синтаксического анализа статических строк, которые включают ParseExact Parse, TryParse, и TryParseExact.You can also initialize a DateTimeOffset value from the string representation of a date and time by calling a number of static string parsing methods, which include Parse, ParseExact, TryParse, and TryParseExact.

Члены DateTimeOffset структуры предоставляют функциональные возможности в следующих областях:The members of the DateTimeOffset structure provide functionality in the following areas:

  • Арифметические операции с датами и временем.Date and time arithmetic.

    Можно добавлять или вычитать либо даты, либо интервалы времени из DateTimeOffset определенного значения.You can add or subtract either dates or time intervals from a particular DateTimeOffset value. Арифметические операции DateTimeOffset со значениями, в отличие от DateTime значений, заменяют различия в смещениях времени при возврате результата.Arithmetic operations with DateTimeOffset values, unlike those with DateTime values, adjust for differences in time offsets when returning a result. Например, в следующем коде переменные используются DateTime для вычитания текущего местного времени из текущего времени в формате UTC.For example, the following code uses DateTime variables to subtract the current local time from the current UTC time. Затем в коде используются DateTimeOffset переменные для выполнения одной операции.The code then uses DateTimeOffset variables to perform the same operation. Вычитание со DateTime значениями возвращает разность местного часового пояса от времени в формате UTC, в то время DateTimeOffset как вычитание с возвращаемыми TimeSpan.Zeroзначениями.The subtraction with DateTime values returns the local time zone's difference from UTC, while the subtraction with DateTimeOffset values returns TimeSpan.Zero.

    using System;
    
    public class DateArithmetic
    {
       public static void Main()
       {
          DateTime date1, date2;
          DateTimeOffset dateOffset1, dateOffset2;
          TimeSpan difference;
          
          // Find difference between Date.Now and Date.UtcNow
          date1 = DateTime.Now;
          date2 = DateTime.UtcNow;
          difference = date1 - date2;
          Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);
          
          // Find difference between Now and UtcNow using DateTimeOffset
          dateOffset1 = DateTimeOffset.Now;
          dateOffset2 = DateTimeOffset.UtcNow;
          difference = dateOffset1 - dateOffset2;
          Console.WriteLine("{0} - {1} = {2}", 
                            dateOffset1, dateOffset2, difference);
          // If run in the Pacific Standard time zone on 4/2/2007, the example
          // displays the following output to the console:
          //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
          //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
       }
    }
    
    Module DateArithmetic
       Public Sub Main()
          Dim date1, date2 As Date
          Dim dateOffset1, dateOffset2 As DateTimeOffset
          Dim difference As TimeSpan
          
          ' Find difference between Date.Now and Date.UtcNow
          date1 = Date.Now
          date2 = Date.UtcNow
          difference = date1 - date2
          Console.WriteLine("{0} - {1} = {2}", date1, date2, difference)
          
          ' Find difference between Now and UtcNow using DateTimeOffset
          dateOffset1 = date.Now
          dateOffset2 = date.UtcNow
          difference = dateOffset1 - dateOffset2
          Console.WriteLine("{0} - {1} = {2}", _
                            dateOffset1, dateOffset2, difference)
          ' If run in the Pacific Standard time zone on 4/2/2007, the example
          ' displays the following output to the console:
          '    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
          '    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
       End Sub
    End Module
    
  • Операции преобразования типов.Type conversion operations.

    Можно преобразовать DateTimeOffset значения в DateTime значения и наоборот.You can convert DateTimeOffset values to DateTime values and vice versa.

  • Операции обработки и извлечения времени.Time manipulation and extraction operations.

    Можно извлечь дату или время для DateTimeOffset значения.You can extract either the date or the time of a DateTimeOffset value. Можно также получить значение определенного DateTimeOffset компонента, например его год или месяц.You can also retrieve the value of a particular DateTimeOffset component, such as its year or its month.

Примечание

При работе со значением тактов, которое необходимо преобразовать в какой-либо другой интервал времени, например в минуты или TimeSpan.TicksPerDayсекунды, следует использовать константу TimeSpan.TicksPerMinute, TimeSpan.TicksPerHour TimeSpan.TicksPerSecond,, или TimeSpan.TicksPerMillisecond , чтобы выполнить преобразование.If you are working with a ticks value that you want to convert to some other time interval, such as minutes or seconds, you should use the TimeSpan.TicksPerDay, TimeSpan.TicksPerHour, TimeSpan.TicksPerMinute, TimeSpan.TicksPerSecond, or TimeSpan.TicksPerMillisecond constant to perform the conversion. Например, чтобы добавить число секунд, представленное указанным числом тактов, в Second компонент DateTimeOffset значения, можно использовать выражение dateValue.Second + nTicks/Timespan.TicksPerSecond.For example, to add the number of seconds represented by a specified number of ticks to the Second component of a DateTimeOffset value, you can use the expression dateValue.Second + nTicks/Timespan.TicksPerSecond.

  • Преобразование даты и времени.Date and time conversion.

    Любое DateTimeOffset значение можно преобразовать в другое DateTimeOffset значение, представляющее тот же момент времени в другом часовом поясе.You can convert any DateTimeOffset value to another DateTimeOffset value that represents the same point in time in another time zone. Однако правила коррекции часового пояса применяются только в случае ToLocalTime метода, который DateTimeOffset преобразует значение в дату и время в локальной системной зоне.However, a time zone's adjustment rules are applied only in the case of the ToLocalTime method, which converts a DateTimeOffset value to the date and time in the local system zone.

  • Сравнение даты и времени.Date and time comparison.

    Можно определить, является ли какое DateTimeOffset -либо конкретное значение более ранним, чем другое DateTimeOffset значение, или более поздним.You can determine whether any particular DateTimeOffset value is earlier than, the same as, or later than another DateTimeOffset value. Перед выполнением сравнения все значения преобразуются в формат UTC.Before the comparison is performed, all values are converted to UTC.

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

DateTimeOffset(DateTime) DateTimeOffset(DateTime) DateTimeOffset(DateTime) DateTimeOffset(DateTime)

Инициализирует новый экземпляр структуры DateTimeOffset с использованием заданного значения DateTime.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.

DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan)

Инициализирует новый экземпляр структуры DateTimeOffset с использованием заданного значения DateTime и смещения.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan)

Инициализирует новый экземпляр структуры DateTimeOffset с использованием заданного количества тактов и смещения.Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Инициализирует новый экземпляр структуры DateTimeOffset, используя указанный год, месяц, день, час, минуту, секунду и смещение.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

Инициализирует новый экземпляр структуры DateTimeOffset, используя указанные год, месяц, день, час, минуту, секунду, миллисекунду и смещение.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

Инициализирует новый экземпляр структуры DateTimeOffset, используя указанные год, месяц, день, час, минуту, секунду, миллисекунду и смещение для заданного календаря.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.

Поля

MaxValue MaxValue MaxValue MaxValue

Представляет максимально допустимое значение типа DateTimeOffset.Represents the greatest possible value of DateTimeOffset. Это поле доступно только для чтения.This field is read-only.

MinValue MinValue MinValue MinValue

Представляет наиболее раннее из возможных значений DateTimeOffset.Represents the earliest possible DateTimeOffset value. Это поле доступно только для чтения.This field is read-only.

UnixEpoch UnixEpoch UnixEpoch UnixEpoch

Свойства

Date Date Date Date

Получает значение DateTime, представляющее компонент даты в текущем объекте DateTimeOffset.Gets a DateTime value that represents the date component of the current DateTimeOffset object.

DateTime DateTime DateTime DateTime

Получает значение DateTime, представляющее дату и время текущего объекта DateTimeOffset.Gets a DateTime value that represents the date and time of the current DateTimeOffset object.

Day Day Day Day

Возвращает день месяца, представленный текущим объектом DateTimeOffset.Gets the day of the month represented by the current DateTimeOffset object.

DayOfWeek DayOfWeek DayOfWeek DayOfWeek

Возвращает день недели, представленный текущим объектом DateTimeOffset.Gets the day of the week represented by the current DateTimeOffset object.

DayOfYear DayOfYear DayOfYear DayOfYear

Возвращает день года, представленный текущим объектом DateTimeOffset.Gets the day of the year represented by the current DateTimeOffset object.

Hour Hour Hour Hour

Возвращает часовой компонент, представленный текущим объектом DateTimeOffset.Gets the hour component of the time represented by the current DateTimeOffset object.

LocalDateTime LocalDateTime LocalDateTime LocalDateTime

Получает значение DateTime, представляющее местную дату и время в текущем объекте DateTimeOffset.Gets a DateTime value that represents the local date and time of the current DateTimeOffset object.

Millisecond Millisecond Millisecond Millisecond

Возвращает временной компонент миллисекунд, представленный текущим объектом DateTimeOffset.Gets the millisecond component of the time represented by the current DateTimeOffset object.

Minute Minute Minute Minute

Возвращает компонент минут, представленный текущим объектом DateTimeOffset.Gets the minute component of the time represented by the current DateTimeOffset object.

Month Month Month Month

Возвращает компонент месяца даты, представленный текущим объектом DateTimeOffset.Gets the month component of the date represented by the current DateTimeOffset object.

Now Now Now Now

Возвращает объект DateTimeOffset, для которого в качестве значения установлены текущие дата и время на текущем компьютере, а в качестве смещения — смещение местного времени от времени в формате UTC.Gets a DateTimeOffset object that is set to the current date and time on the current computer, with the offset set to the local time's offset from Coordinated Universal Time (UTC).

Offset Offset Offset Offset

Возвращает смещение по времени от времени в формате UTC.Gets the time's offset from Coordinated Universal Time (UTC).

Second Second Second Second

Возвращает компонент секунд по показаниям часов, представленный текущим объектом DateTimeOffset.Gets the second component of the clock time represented by the current DateTimeOffset object.

Ticks Ticks Ticks Ticks

Возвращает количество тактов, представляющее местную дату и время в текущем объекте DateTimeOffset по показаниям часов.Gets the number of ticks that represents the date and time of the current DateTimeOffset object in clock time.

TimeOfDay TimeOfDay TimeOfDay TimeOfDay

Получает время суток текущего объекта DateTimeOffset.Gets the time of day for the current DateTimeOffset object.

UtcDateTime UtcDateTime UtcDateTime UtcDateTime

Получает значение DateTime, представляющее дату и время текущего объекта DateTimeOffset в формате UTC.Gets a DateTime value that represents the Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

UtcNow UtcNow UtcNow UtcNow

Возвращает объект DateTimeOffset, в качестве даты и времени которого установлены текущие дата и время в формате UTC, а в качестве смещения — значение Zero.Gets a DateTimeOffset object whose date and time are set to the current Coordinated Universal Time (UTC) date and time and whose offset is Zero.

UtcTicks UtcTicks UtcTicks UtcTicks

Возвращает количество тактов, которое представляет дату и время текущего объекта DateTimeOffset в формате UTC.Gets the number of ticks that represents the date and time of the current DateTimeOffset object in Coordinated Universal Time (UTC).

Year Year Year Year

Возвращает компонент года даты, представленный текущим объектом DateTimeOffset.Gets the year component of the date represented by the current DateTimeOffset object.

Методы

Add(TimeSpan) Add(TimeSpan) Add(TimeSpan) Add(TimeSpan)

Возвращает новый объект DateTimeOffset, добавляющий указанный интервал времени к значению этого экземпляра.Returns a new DateTimeOffset object that adds a specified time interval to the value of this instance.

AddDays(Double) AddDays(Double) AddDays(Double) AddDays(Double)

Возвращает новый объект DateTimeOffset, прибавляющий заданное количество полных и неполных дней к значению данного экземпляра.Returns a new DateTimeOffset object that adds a specified number of whole and fractional days to the value of this instance.

AddHours(Double) AddHours(Double) AddHours(Double) AddHours(Double)

Возвращает новый объект DateTimeOffset, добавляющий заданное количество полных и неполных часов к значению этого экземпляра.Returns a new DateTimeOffset object that adds a specified number of whole and fractional hours to the value of this instance.

AddMilliseconds(Double) AddMilliseconds(Double) AddMilliseconds(Double) AddMilliseconds(Double)

Возвращает новый объект DateTimeOffset, прибавляющий заданное число миллисекунд к значению данного экземпляра.Returns a new DateTimeOffset object that adds a specified number of milliseconds to the value of this instance.

AddMinutes(Double) AddMinutes(Double) AddMinutes(Double) AddMinutes(Double)

Возвращает новый объект DateTimeOffset, прибавляющий заданное количество полных и неполных минут к значению данного экземпляра.Returns a new DateTimeOffset object that adds a specified number of whole and fractional minutes to the value of this instance.

AddMonths(Int32) AddMonths(Int32) AddMonths(Int32) AddMonths(Int32)

Возвращает новый объект DateTimeOffset, добавляющий заданное число месяцев к значению данного экземпляра.Returns a new DateTimeOffset object that adds a specified number of months to the value of this instance.

AddSeconds(Double) AddSeconds(Double) AddSeconds(Double) AddSeconds(Double)

Возвращает новый объект DateTimeOffset, прибавляющий заданное количество полных и неполных секунд к значению данного экземпляра.Returns a new DateTimeOffset object that adds a specified number of whole and fractional seconds to the value of this instance.

AddTicks(Int64) AddTicks(Int64) AddTicks(Int64) AddTicks(Int64)

Возвращает новый объект DateTimeOffset, прибавляющий заданное число тактов к значению этого экземпляра.Returns a new DateTimeOffset object that adds a specified number of ticks to the value of this instance.

AddYears(Int32) AddYears(Int32) AddYears(Int32) AddYears(Int32)

Возвращает новый объект DateTimeOffset, прибавляющий заданное число лет к значению этого экземпляра.Returns a new DateTimeOffset object that adds a specified number of years to the value of this instance.

Compare(DateTimeOffset, DateTimeOffset) Compare(DateTimeOffset, DateTimeOffset) Compare(DateTimeOffset, DateTimeOffset) Compare(DateTimeOffset, DateTimeOffset)

Сравнивает два объекта DateTimeOffset, и указывает, как соотносятся между собой указанные в них моменты времени: первый раньше второго, первый и второй равны, или же первый позже второго.Compares two DateTimeOffset objects and indicates whether the first is earlier than the second, equal to the second, or later than the second.

CompareTo(DateTimeOffset) CompareTo(DateTimeOffset) CompareTo(DateTimeOffset) CompareTo(DateTimeOffset)

Сравнивает текущий объект DateTimeOffset с заданным объектом DateTimeOffset и указывает, когда наступает момент, заданный в первом объекте: раньше, позже или одновременно с моментом, указанным во втором объекте DateTimeOffset.Compares the current DateTimeOffset object to a specified DateTimeOffset object and indicates whether the current object is earlier than, the same as, or later than the second DateTimeOffset object.

Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset)

Определяет, представляет ли текущий объект DateTimeOffset тот же момент времени, что и заданный объект DateTimeOffset.Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, представляет ли объект DateTimeOffset тот же момент времени, что и заданный объект.Determines whether a DateTimeOffset object represents the same point in time as a specified object.

Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset)

Определяет, представляют ли два заданных объекта DateTimeOffset один и тот же момент времени.Determines whether two specified DateTimeOffset objects represent the same point in time.

EqualsExact(DateTimeOffset) EqualsExact(DateTimeOffset) EqualsExact(DateTimeOffset) EqualsExact(DateTimeOffset)

Определяет, представляет ли текущий объект DateTimeOffset тот же момент времени, что и заданный объект DateTimeOffset и совпадают ли их смещения.Determines whether the current DateTimeOffset object represents the same time and has the same offset as a specified DateTimeOffset object.

FromFileTime(Int64) FromFileTime(Int64) FromFileTime(Int64) FromFileTime(Int64)

Преобразует заданное время файла Windows в его эквивалент по местному времени.Converts the specified Windows file time to an equivalent local time.

FromUnixTimeMilliseconds(Int64) FromUnixTimeMilliseconds(Int64) FromUnixTimeMilliseconds(Int64) FromUnixTimeMilliseconds(Int64)

Преобразует время в формате Unix, выраженное как количество миллисекунд, истекших с 1970-01-01T00:00:00Z, в значение DateTimeOffset.Converts a Unix time expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z to a DateTimeOffset value.

FromUnixTimeSeconds(Int64) FromUnixTimeSeconds(Int64) FromUnixTimeSeconds(Int64) FromUnixTimeSeconds(Int64)

Преобразует время в формате Unix, выраженное как количество секунд, истекших с 1970-01-01T00:00:00Z, в значение DateTimeOffset.Converts a Unix time expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z to a DateTimeOffset value.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код для текущего объекта DateTimeOffset.Returns the hash code for the current DateTimeOffset object.

Parse(String) Parse(String) Parse(String) Parse(String)

Преобразует заданное строковое представление даты, времени и смещения в его эквивалент DateTimeOffset.Converts the specified string representation of a date, time, and offset to its DateTimeOffset equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Преобразует заданное строковое представление даты и времени в его эквивалент DateTimeOffset, используя указанные сведения о форматировании, связанные с языком и региональными параметрами.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information.

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)
Parse(String, IFormatProvider, DateTimeStyles) Parse(String, IFormatProvider, DateTimeStyles) Parse(String, IFormatProvider, DateTimeStyles) Parse(String, IFormatProvider, DateTimeStyles)

Преобразует заданное строковое представление даты и времени в его эквивалент DateTimeOffset, используя указанную информацию о форматировании, связанную с языком и региональными параметрами, а также заданный стиль форматирования.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information and formatting style.

ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles) ParseExact(String, String[], IFormatProvider, DateTimeStyles)

Преобразует заданное строковое представление даты и времени в его эквивалент DateTimeOffset, используя заданные форматы, сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified formats, culture-specific format information, and style. Формат строкового представления должен полностью соответствовать одному из заданных форматов.The format of the string representation must match one of the specified formats exactly.

ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles) ParseExact(String, String, IFormatProvider, DateTimeStyles)

Преобразует заданное строковое представление даты и времени в его эквивалент DateTimeOffset, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Формат строкового представления должен полностью соответствовать заданному формату.The format of the string representation must match the specified format exactly.

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Преобразует диапазон символов, отображающий дату и время, в его эквивалент DateTimeOffset, используя заданный формат, сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts a character span that represents a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Формат отображения даты и времени должен полностью соответствовать заданному формату.The format of the date and time representation must match the specified format exactly.

ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider) ParseExact(String, String, IFormatProvider)

Преобразует заданное строковое представление даты и времени в его эквивалент DateTimeOffset, используя указанные сведения о форматировании, связанные с языком и региональными параметрами.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format and culture-specific format information. Формат строкового представления должен полностью соответствовать заданному формату.The format of the string representation must match the specified format exactly.

ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)

Преобразует диапазон символов, содержащий строковое представление даты и времени, в его эквивалент DateTimeOffset, используя заданные форматы, сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts a character span that contains the string representation of a date and time to its DateTimeOffset equivalent using the specified formats, culture-specific format information, and style. Формат представления даты и времени должен полностью соответствовать одному из заданных форматов.The format of the date and time representation must match one of the specified formats exactly.

Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset) Subtract(DateTimeOffset)

Вычитает значение DateTimeOffset, представляющее определенную дату и время, из текущего объекта DateTimeOffset.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Вычитает указанный интервал времени из текущего объекта DateTimeOffset.Subtracts a specified time interval from the current DateTimeOffset object.

ToFileTime() ToFileTime() ToFileTime() ToFileTime()

Преобразует значение текущего объекта DateTimeOffset во временную характеристику файла Windows.Converts the value of the current DateTimeOffset object to a Windows file time.

ToLocalTime() ToLocalTime() ToLocalTime() ToLocalTime()

Преобразует текущий объект DateTimeOffset в объект DateTimeOffset, представляющий местное время.Converts the current DateTimeOffset object to a DateTimeOffset object that represents the local time.

ToOffset(TimeSpan) ToOffset(TimeSpan) ToOffset(TimeSpan) ToOffset(TimeSpan)

Преобразует значение текущего объекта DateTimeOffset в дату и время, указанные в значении смещения.Converts the value of the current DateTimeOffset object to the date and time specified by an offset value.

ToString() ToString() ToString() ToString()

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление.Converts the value of the current DateTimeOffset object to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Преобразует числовое значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление с использованием заданного формата.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Преобразует значение текущего объекта DateTimeOffset в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для данного языка и региональных параметров.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

ToUniversalTime() ToUniversalTime() ToUniversalTime() ToUniversalTime()

Преобразует текущий объект DateTimeOffset в значение DateTimeOffset, представляющее время в формате UTC.Converts the current DateTimeOffset object to a DateTimeOffset value that represents the Coordinated Universal Time (UTC).

ToUnixTimeMilliseconds() ToUnixTimeMilliseconds() ToUnixTimeMilliseconds() ToUnixTimeMilliseconds()

Возвращает количество миллисекунд, истекших с 1970-01-01T00:00:00.000Z.Returns the number of milliseconds that have elapsed since 1970-01-01T00:00:00.000Z.

ToUnixTimeSeconds() ToUnixTimeSeconds() ToUnixTimeSeconds() ToUnixTimeSeconds()

Возвращает количество секунд, истекших с 1970-01-01T00:00:00Z.Returns the number of seconds that have elapsed since 1970-01-01T00:00:00Z.

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Предпринимает попытку преобразования указанного строкового представления даты и времени в его эквивалент DateTimeOffset и возвращает значение, позволяющее определить успешность преобразования.Tries to convert a specified string representation of a date and time to its DateTimeOffset equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)
TryParse(String, DateTimeOffset) TryParse(String, DateTimeOffset) TryParse(String, DateTimeOffset) TryParse(String, DateTimeOffset)

Предпринимает попытку преобразования указанного строкового представления даты и времени в его эквивалент DateTimeOffset и возвращает значение, позволяющее определить успешность преобразования.Tries to converts a specified string representation of a date and time to its DateTimeOffset equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, DateTimeOffset) TryParse(ReadOnlySpan<Char>, DateTimeOffset) TryParse(ReadOnlySpan<Char>, DateTimeOffset) TryParse(ReadOnlySpan<Char>, DateTimeOffset)
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)

Преобразует заданное строковое представление даты и времени в его эквивалент DateTimeOffset, используя заданный массив форматов, указанные сведения о форматировании, связанные с языком и региональными параметрами, и стиль форматирования.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified array of formats, culture-specific format information, and style. Формат строкового представления должен полностью соответствовать одному из заданных форматов.The format of the string representation must match one of the specified formats exactly.

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)

Преобразует представление даты и времени в диапазоне символов в его эквивалент DateTimeOffset, используя заданный формат, сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts the representation of a date and time in a character span to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Формат отображения даты и времени должен полностью соответствовать заданному формату.The format of the date and time representation must match the specified format exactly.

TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset) TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)

Преобразует заданное строковое представление даты и времени в его эквивалент DateTimeOffset, используя заданный формат, указанные сведения о форматировании, связанные с языком и региональными параметрами, а также стиль.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. Формат строкового представления должен полностью соответствовать заданному формату.The format of the string representation must match the specified format exactly.

Операторы

Addition(DateTimeOffset, TimeSpan) Addition(DateTimeOffset, TimeSpan) Addition(DateTimeOffset, TimeSpan) Addition(DateTimeOffset, TimeSpan)

Добавляет указанный интервал времени в объект DateTimeOffset, имеющий заданную дату и время, и образует объект DateTimeOffset с новыми значениями даты и времени.Adds a specified time interval to a DateTimeOffset object that has a specified date and time, and yields a DateTimeOffset object that has new a date and time.

Equality(DateTimeOffset, DateTimeOffset) Equality(DateTimeOffset, DateTimeOffset) Equality(DateTimeOffset, DateTimeOffset) Equality(DateTimeOffset, DateTimeOffset)

Определяет, представляют ли два заданных объекта DateTimeOffset один и тот же момент времени.Determines whether two specified DateTimeOffset objects represent the same point in time.

GreaterThan(DateTimeOffset, DateTimeOffset) GreaterThan(DateTimeOffset, DateTimeOffset) GreaterThan(DateTimeOffset, DateTimeOffset) GreaterThan(DateTimeOffset, DateTimeOffset)

Определяет, больше ли (или меньше) значение одного указанного объекта DateTimeOffset значения другого указанного объекта DateTimeOffset.Determines whether one specified DateTimeOffset object is greater than (or later than) a second specified DateTimeOffset object.

GreaterThanOrEqual(DateTimeOffset, DateTimeOffset) GreaterThanOrEqual(DateTimeOffset, DateTimeOffset) GreaterThanOrEqual(DateTimeOffset, DateTimeOffset) GreaterThanOrEqual(DateTimeOffset, DateTimeOffset)

Определяет, действительно ли значение одного указанного объекта DateTimeOffset больше или равно значению другого указанного объекта DateTimeOffset.Determines whether one specified DateTimeOffset object is greater than or equal to a second specified DateTimeOffset object.

Implicit(DateTime to DateTimeOffset) Implicit(DateTime to DateTimeOffset) Implicit(DateTime to DateTimeOffset) Implicit(DateTime to DateTimeOffset)

Определяется неявное преобразование объекта DateTime в объект DateTimeOffset.Defines an implicit conversion of a DateTime object to a DateTimeOffset object.

Inequality(DateTimeOffset, DateTimeOffset) Inequality(DateTimeOffset, DateTimeOffset) Inequality(DateTimeOffset, DateTimeOffset) Inequality(DateTimeOffset, DateTimeOffset)

Определяет, указывают ли два заданных объекта DateTimeOffset на разные моменты времени.Determines whether two specified DateTimeOffset objects refer to different points in time.

LessThan(DateTimeOffset, DateTimeOffset) LessThan(DateTimeOffset, DateTimeOffset) LessThan(DateTimeOffset, DateTimeOffset) LessThan(DateTimeOffset, DateTimeOffset)

Определяет, меньше ли значение одного указанного объекта DateTimeOffset, чем значение другого указанного объекта DateTimeOffset.Determines whether one specified DateTimeOffset object is less than a second specified DateTimeOffset object.

LessThanOrEqual(DateTimeOffset, DateTimeOffset) LessThanOrEqual(DateTimeOffset, DateTimeOffset) LessThanOrEqual(DateTimeOffset, DateTimeOffset) LessThanOrEqual(DateTimeOffset, DateTimeOffset)

Определяет, меньше ли значение одного указанного объекта DateTimeOffset, чем значение другого указанного объекта DateTimeOffset.Determines whether one specified DateTimeOffset object is less than a second specified DateTimeOffset object.

Subtraction(DateTimeOffset, DateTimeOffset) Subtraction(DateTimeOffset, DateTimeOffset) Subtraction(DateTimeOffset, DateTimeOffset) Subtraction(DateTimeOffset, DateTimeOffset)

Вычитает объект DateTimeOffset из другого объекта и выдает интервал времени.Subtracts one DateTimeOffset object from another and yields a time interval.

Subtraction(DateTimeOffset, TimeSpan) Subtraction(DateTimeOffset, TimeSpan) Subtraction(DateTimeOffset, TimeSpan) Subtraction(DateTimeOffset, TimeSpan)

Вычитает заданный временной интервал из указанной даты и времени и выдает новую дату и время.Subtracts a specified time interval from a specified date and time, and yields a new date and time.

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

IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object)

Сравнивает значение текущего объекта DateTimeOffset с другим объектом того же типа.Compares the value of the current DateTimeOffset object with another object of the same type.

IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object)

Выполняется после завершения десериализации объекта.Runs when the deserialization of an object has been completed.

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Передает объекту SerializationInfo данные, необходимые для сериализации текущего объекта DateTimeOffset.Populates a SerializationInfo object with the data required to serialize the current DateTimeOffset object.

Применяется к

Дополнительно