DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset Struct

Definição

Representa um ponto no tempo, geralmente expresso como uma data e hora do dia, em relação ao Tempo Universal Coordenado (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
Herança
DateTimeOffsetDateTimeOffsetDateTimeOffsetDateTimeOffset
Atributos
Implementações

Comentários

A DateTimeOffset estrutura inclui um DateTime valor, junto com uma Offset propriedade que define a diferença entre a data DateTimeOffset e hora da instância atual e o UTC (tempo Universal Coordenado).The 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). Como ele define exatamente uma data e hora em relação ao UTC, DateTimeOffset a estrutura não inclui um Kind membro, como faz DateTime a estrutura.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. Ele representa datas e horas com valores cujos intervalos de UTC de 12:00:00 a meia-noite, 1º de janeiro de 0001 Anno Domini (era comum), a 11:59:59 P.M., 31 de dezembro, 9999 D.C.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.).

Importante

As eras nos calendários japoneses se baseiam no reinado do Imperador e, portanto, estão sujeitas a alterações.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Por exemplo, 1º de maio de 2019 marcou o início da era Reiwa no JapaneseCalendar e no JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Tal alteração de eras afeta todos os aplicativos que usam esses calendários.Such a change of era affects all applications that use these calendars. Veja Tratamento de uma nova era no calendário japonês no .NET para obter mais informações e para determinar se seus aplicativos são afetados.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Veja Preparar seu aplicativo para a mudança de era no calendário japonês para obter informações sobre como testar seus aplicativos em sistemas Windows para assegurar que eles estejam preparados para a alteração de era.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. Confira Trabalhando com eras para ver recursos do .NET que dão suporte a calendários com várias eras e confira práticas recomendadas de trabalho com calendários que dão suporte a várias eras.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.

O componente de tempo de DateTimeOffset um valor é medido em unidades de 100 a nanossegundos chamadas, e uma data específica é o número de tiques desde 12:00, meia-noite, 1º de janeiro de 0001 d.c.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. (C.E.) GregorianCalendar no calendário.(C.E.) in the GregorianCalendar calendar. Um DateTimeOffset valor é sempre expresso no contexto de um calendário padrão ou explícito.A DateTimeOffset value is always expressed in the context of an explicit or default calendar. Os tiques que são atribuíveis a segundos bissextos não são incluídos no número total de tiques.Ticks that are attributable to leap seconds are not included in the total number of ticks.

Embora um DateTimeOffset valor inclua um deslocamento, ele não é uma estrutura de dados totalmente com reconhecimento de fuso horário.Although a DateTimeOffset value includes an offset, it is not a fully time zone-aware data structure. Embora um deslocamento do UTC seja uma característica de um fuso horário, ele não identifica inequivocamente um fuso horário.While an offset from UTC is one characteristic of a time zone, it does not unambiguously identify a time zone. Não apenas vários fusos horários compartilham o mesmo deslocamento do UTC, mas o deslocamento de um único fuso horário é alterado se ele observa o horário de verão.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. Isso significa que, assim que um DateTimeOffset valor é desassociado de seu fuso horário, ele não pode mais ser vinculado de forma não ambígua ao seu fuso horário original.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.

Como DateTimeOffset é uma estrutura, um DateTimeOffset objeto que foi declarado mas não inicializado de outra forma contém os valores padrão para cada um de seus campos de membro.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. Isso significa que sua DateTime propriedade é definida como DateTimeOffset.MinValue e sua Offset propriedade é definida como TimeSpan.Zero.This means that its DateTime property is set to DateTimeOffset.MinValue and its Offset property is set to TimeSpan.Zero.

Você pode criar um novo DateTimeOffset valor chamando qualquer uma das sobrecargas de seu construtor, que são semelhantes aos construtores DateTime sobrecarregados da estrutura.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. Você também pode criar um novo DateTimeOffset valor atribuindo a ele um DateTime valor.You can also create a new DateTimeOffset value by assigning it a DateTime value. Esta é uma conversão implícita; Ele não requer um operador de conversão (in C#) ou uma chamada para um método Conversion (em 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). Você também pode inicializar um DateTimeOffset valor da representação de cadeia de caracteres de uma data e hora chamando um número de métodos de análise de cadeia de caracteres Parseestática, TryParseque incluem TryParseExact, ParseExact, e.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.

Os membros da DateTimeOffset estrutura fornecem funcionalidade nas seguintes áreas:The members of the DateTimeOffset structure provide functionality in the following areas:

  • Aritmética de data e hora.Date and time arithmetic.

    Você pode adicionar ou subtrair datas ou intervalos de tempo de DateTimeOffset um valor específico.You can add or subtract either dates or time intervals from a particular DateTimeOffset value. Operações aritméticas DateTimeOffset com valores, diferentemente DateTime daqueles com valores, se ajustam para diferenças em deslocamentos de tempo ao retornar um resultado.Arithmetic operations with DateTimeOffset values, unlike those with DateTime values, adjust for differences in time offsets when returning a result. Por exemplo, o código a seguir DateTime usa variáveis para subtrair a hora local atual da hora UTC atual.For example, the following code uses DateTime variables to subtract the current local time from the current UTC time. Em seguida, o DateTimeOffset código usa variáveis para executar a mesma operação.The code then uses DateTimeOffset variables to perform the same operation. A subtração com DateTime valores retorna a diferença do fuso horário local do UTC, enquanto a subtração com DateTimeOffset valores retorna 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
    
  • Operações de conversão de tipo.Type conversion operations.

    Você pode converter DateTimeOffset valores em DateTime valores e vice-versa.You can convert DateTimeOffset values to DateTime values and vice versa.

  • Operações de manipulação e extração de tempo.Time manipulation and extraction operations.

    Você pode extrair a data ou a hora de um DateTimeOffset valor.You can extract either the date or the time of a DateTimeOffset value. Você também pode recuperar o valor de um componente DateTimeOffset específico, como seu ano ou seu mês.You can also retrieve the value of a particular DateTimeOffset component, such as its year or its month.

Observação

Se você estiver trabalhando com um valor de tiques que deseja converter em algum outro intervalo de tempo, como minutos ou segundos, TimeSpan.TicksPerDaydeverá usar a constante TimeSpan.TicksPerMinute, TimeSpan.TicksPerHour,, TimeSpan.TicksPerSecondou TimeSpan.TicksPerMillisecond para executar a conversão.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. Por exemplo, para adicionar o número de segundos representados por um número especificado de tiques ao Second componente de um DateTimeOffset valor, você pode usar a expressão 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.

  • Conversão de data e hora.Date and time conversion.

    Você pode converter qualquer DateTimeOffset valor em outro DateTimeOffset valor que represente o mesmo ponto no tempo em outro fuso horário.You can convert any DateTimeOffset value to another DateTimeOffset value that represents the same point in time in another time zone. No entanto, as regras de ajuste de um fuso horário são aplicadas somente no ToLocalTime caso do método, que DateTimeOffset converte um valor para a data e hora na zona do sistema local.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.

  • Comparação de data e hora.Date and time comparison.

    Você pode determinar se qualquer valor DateTimeOffset específico é anterior a, o mesmo que ou posterior a outro DateTimeOffset valor.You can determine whether any particular DateTimeOffset value is earlier than, the same as, or later than another DateTimeOffset value. Antes da comparação ser executada, todos os valores são convertidos em UTC.Before the comparison is performed, all values are converted to UTC.

Construtores

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

Inicializa uma nova instância da estrutura DateTimeOffset usando o valor 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)

Inicializa uma nova instância da estrutura DateTimeOffset usando o valor DateTime e deslocamento especificados.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)

Inicializa uma nova instância da estrutura DateTimeOffset usando o número de tiques e deslocamento especificados.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)

Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo e deslocamento especificados.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)

Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo, milissegundo e deslocamento especificados.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)

Inicializa uma nova instância da estrutura DateTimeOffset usando o ano, mês, dia, hora, minuto, segundo, milissegundo e deslocamento especificados de um calendário especificado.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.

Campos

MaxValue MaxValue MaxValue MaxValue

Representa o maior valor possível de DateTimeOffset.Represents the greatest possible value of DateTimeOffset. Este campo é somente leitura.This field is read-only.

MinValue MinValue MinValue MinValue

Representa o primeiro valor possível de DateTimeOffset.Represents the earliest possible DateTimeOffset value. Este campo é somente leitura.This field is read-only.

UnixEpoch UnixEpoch UnixEpoch UnixEpoch

Propriedades

Date Date Date Date

Obtém um valor DateTime que representa o componente de data do objeto DateTimeOffset atual.Gets a DateTime value that represents the date component of the current DateTimeOffset object.

DateTime DateTime DateTime DateTime

Obtém um valor DateTime que representa a data e hora do objeto DateTimeOffset atual.Gets a DateTime value that represents the date and time of the current DateTimeOffset object.

Day Day Day Day

Obtém o dia do mês representado pelo objeto DateTimeOffset atual.Gets the day of the month represented by the current DateTimeOffset object.

DayOfWeek DayOfWeek DayOfWeek DayOfWeek

Obtém o dia da semana representado pelo objeto DateTimeOffset atual.Gets the day of the week represented by the current DateTimeOffset object.

DayOfYear DayOfYear DayOfYear DayOfYear

Obtém o dia do ano representado pelo objeto DateTimeOffset atual.Gets the day of the year represented by the current DateTimeOffset object.

Hour Hour Hour Hour

Obtém o componente de hora do tempo representado pelo objeto DateTimeOffset atual.Gets the hour component of the time represented by the current DateTimeOffset object.

LocalDateTime LocalDateTime LocalDateTime LocalDateTime

Obtém um valor DateTime que representa a data e hora locais do objeto DateTimeOffset atual.Gets a DateTime value that represents the local date and time of the current DateTimeOffset object.

Millisecond Millisecond Millisecond Millisecond

Obtém o componente de milissegundo do tempo representado pelo objeto DateTimeOffset atual.Gets the millisecond component of the time represented by the current DateTimeOffset object.

Minute Minute Minute Minute

Obtém o componente de minuto do tempo representado pelo objeto DateTimeOffset atual.Gets the minute component of the time represented by the current DateTimeOffset object.

Month Month Month Month

Obtém o componente de mês da data representada pelo objeto DateTimeOffset atual.Gets the month component of the date represented by the current DateTimeOffset object.

Now Now Now Now

Obtém um objeto DateTimeOffset definido como a data e hora atual no computador atual, com o deslocamento definido como o deslocamento de hora local do UTC (Tempo Universal Coordenado).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

Obtém o deslocamento de UTC (Tempo Universal Coordenado).Gets the time's offset from Coordinated Universal Time (UTC).

Second Second Second Second

Obtém o componente de segundo da hora do relógio representado pelo objeto DateTimeOffset atual.Gets the second component of the clock time represented by the current DateTimeOffset object.

Ticks Ticks Ticks Ticks

Obtém o número de tiques que representa a data e hora do objeto DateTimeOffset atual na hora do relógio.Gets the number of ticks that represents the date and time of the current DateTimeOffset object in clock time.

TimeOfDay TimeOfDay TimeOfDay TimeOfDay

Obtém a hora do dia para o objeto DateTimeOffset atual.Gets the time of day for the current DateTimeOffset object.

UtcDateTime UtcDateTime UtcDateTime UtcDateTime

Obtém um valor DateTime que representa da data e hora UTC (Tempo Universal Coordenado) do objeto DateTimeOffset atual.Gets a DateTime value that represents the Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

UtcNow UtcNow UtcNow UtcNow

Obtém o objeto DateTimeOffset, cuja data e hora estão definidas para o Tempo Universal Coordenado (UTC) atual e cujo deslocamento é 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

Obtém o número de tiques que representa a data e hora do objeto DateTimeOffset atual em UTC (Tempo Universal Coordenado).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

Obtém o componente de ano da data representada pelo objeto DateTimeOffset atual.Gets the year component of the date represented by the current DateTimeOffset object.

Métodos

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

Retorna um novo objeto DateTimeOffset que adiciona um intervalo de tempo especificado ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de dias inteiros e fracionários ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de horas inteiras e fracionárias ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de milissegundos ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de minutos inteiros e fracionários ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de meses ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de segundos inteiros e fracionários ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de tiques ao valor dessa instância.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)

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de anos ao valor dessa instância.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)

Compara dois objetos DateTimeOffset e indica se a primeira é anterior, igual ou posterior ao segundo.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)

Compara o objeto DateTimeOffset atual a um objeto DateTimeOffset especificado e indica se o objeto atual é anterior, o mesmo ou posterior ao segundo objeto 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)

Determina se o objeto DateTimeOffset atual representa o mesmo ponto no tempo que um objeto DateTimeOffset especificado.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)

Determina se um objeto DateTimeOffset representa o mesmo ponto no tempo que um objeto especificado.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)

Determina se dois objetos DateTimeOffset especificados representam o mesmo ponto no tempo.Determines whether two specified DateTimeOffset objects represent the same point in time.

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

Determina se o objeto DateTimeOffset atual representa a mesma hora e tem o mesmo deslocamento que um objeto DateTimeOffset especificado.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)

Converte a hora de arquivo do Windows especificada em uma hora local equivalente.Converts the specified Windows file time to an equivalent local time.

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

Converte um horário do Unix expresso como o número de milissegundos decorridos desde 1970-01-01T00:00:00Z para um valor de 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)

Converte um horário do Unix expresso como o número de segundos decorridos desde 1970-01-01T00:00:00Z em um valor de 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()

Retorna o código hash para o objeto DateTimeOffset atual.Returns the hash code for the current DateTimeOffset object.

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

Converte a representação da cadeia de caracteres especificada de uma data, hora e desvio no DateTimeOffset equivalente.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)

Converte a representação de cadeia de caracteres especificada de data e hora em seu equivalente DateTimeOffset usando as informações de formato específicas da cultura.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)

Converte a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente usando o estilo de formatação e as informações de formato específicos da cultura especificada.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)

Converte a representação da cadeia de caracteres especificada de data e hora em seu equivalente DateTimeOffset usando o formato, informações do formato específico da cultura e o estilo especificados.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified formats, culture-specific format information, and style. O formato da representação da cadeia de caracteres deve corresponder exatamente a um dos formatos especificados.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)

Converte a representação de cadeia de caracteres especificada de data e hora em seu equivalente DateTimeOffset usando o formato especificado, as informações de formato específicas da cultura e o estilo.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. O formato de representação da cadeia de caracteres deve corresponder exatamente ao formato especificado.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)

Converte um intervalo de caracteres que representa uma data e hora em seu equivalente DateTimeOffset usando o formato especificado, as informações de formato específicas da cultura e o estilo.Converts a character span that represents a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. O formato de representação da cadeia de caracteres deve corresponder exatamente ao formato especificado.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)

Converte a representação de cadeia de caracteres especificada de data e hora em seu equivalente DateTimeOffset usando o formato especificado e as informações de formato específicas da cultura.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format and culture-specific format information. O formato de representação da cadeia de caracteres deve corresponder exatamente ao formato especificado.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)

Converte um intervalo de caracteres que contém a representação da cadeia de caracteres especificada de data e hora em seu equivalente DateTimeOffset usando o formato, informações do formato específico da cultura e o estilo especificados.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. O formato da representação de data e hora deve corresponder exatamente a um dos formatos especificados.The format of the date and time representation must match one of the specified formats exactly.

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

Subtrai um valor DateTimeOffset que representa uma data e hora específica do objeto DateTimeOffset atual.Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.

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

Subtrai um intervalo de tempo especificado do objeto DateTimeOffset atual.Subtracts a specified time interval from the current DateTimeOffset object.

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

Converte o valor do objeto DateTimeOffset atual para uma hora de arquivo do Windows.Converts the value of the current DateTimeOffset object to a Windows file time.

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

Converte o objeto DateTimeOffset atual em um objeto DateTimeOffset que representa a hora local.Converts the current DateTimeOffset object to a DateTimeOffset object that represents the local time.

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

Converte o valor do objeto DateTimeOffset atual na data e hora especificada por um valor de deslocamento.Converts the value of the current DateTimeOffset object to the date and time specified by an offset value.

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

Converte o valor do atual objeto DateTimeOffset na representação de cadeia de caracteres equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

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

Converte o valor do objeto DateTimeOffset atual em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.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)

Converte o valor do objeto DateTimeOffset atual em sua representação de cadeia de caracteres equivalente usando o formato especificado.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)

Converte o valor do atual objeto DateTimeOffset na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.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()

Converte o objeto DateTimeOffset atual em um valor DateTimeOffset que representa o UTC (Tempo Universal Coordenado).Converts the current DateTimeOffset object to a DateTimeOffset value that represents the Coordinated Universal Time (UTC).

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

Retorna o número de milissegundos decorridos desde 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()

Retorna o número de segundos decorridos desde 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)

Tenta converter a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida.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)

Tenta converter a representação de cadeia de caracteres especificada de uma data e hora em seu DateTimeOffset equivalente e retorna um valor que indica se a conversão foi bem-sucedida.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)

Converte a representação de cadeia de caracteres especificada de um data e hora no equivalente de DateTimeOffset usando a matriz de formatos, informações de formato específicas da cultura e estilo especificados.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. O formato da representação da cadeia de caracteres deve corresponder exatamente a um dos formatos especificados.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)

Converte a representação de data e hora em um intervalo de caracteres em seu equivalente DateTimeOffset usando o formato especificado, as informações de formato específicas da cultura e o estilo.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. O formato de representação da cadeia de caracteres deve corresponder exatamente ao formato especificado.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)

Converte a representação de cadeia de caracteres especificada de data e hora em seu equivalente DateTimeOffset usando o formato especificado, as informações de formato específicas da cultura e o estilo.Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. O formato de representação da cadeia de caracteres deve corresponder exatamente ao formato especificado.The format of the string representation must match the specified format exactly.

Operadores

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

Adiciona um intervalo de tempo especificado para um objeto DateTimeOffset que tem uma data e hora especificadas e produz um DateTimeOffset objeto que tem uma nova data e hora.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)

Determina se dois objetos DateTimeOffset especificados representam o mesmo ponto no tempo.Determines whether two specified DateTimeOffset objects represent the same point in time.

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

Determina se um objeto DateTimeOffset especificado é maior que (ou posterior a) um segundo objeto DateTimeOffset especificado.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)

Determina se um objeto DateTimeOffset especificado é maior que ou igual a um segundo objeto DateTimeOffset especificado.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)

Define uma conversão implícita de um objeto DateTime como um objeto 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)

Determina se dois objetos DateTimeOffset especificados referem-se a diferentes pontos no tempo.Determines whether two specified DateTimeOffset objects refer to different points in time.

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

Determina se um objeto DateTimeOffset especificado é menor que um segundo objeto DateTimeOffset especificado.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)

Determina se um objeto DateTimeOffset especificado é menor que um segundo objeto DateTimeOffset especificado.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)

Subtrai um objeto DateTimeOffset do outro e produz um intervalo de tempo.Subtracts one DateTimeOffset object from another and yields a time interval.

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

Subtrai um intervalo de tempo especificado de uma data e hora especificada e gera uma nova data e hora.Subtracts a specified time interval from a specified date and time, and yields a new date and time.

Implantações explícitas de interface

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

Compara o valor do objeto DateTimeOffset atual com outro objeto do mesmo tipo.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)

Executado quando a desserialização de um objeto foi concluída.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)

Popula um objeto SerializationInfo com os dados necessários para serializar o objeto DateTimeOffset atual.Populates a SerializationInfo object with the data required to serialize the current DateTimeOffset object.

Aplica-se a

Veja também