DateTimeOffset Estrutura

Definição

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

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public value class DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

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

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, IUtf8SpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, ISpanFormattable, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public readonly struct DateTimeOffset : IComparable, IComparable<DateTimeOffset>, IEquatable<DateTimeOffset>, IParsable<DateTimeOffset>, ISpanFormattable, ISpanParsable<DateTimeOffset>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

public struct 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

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IUtf8SpanFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface ISpanFormattable
    interface IFormattable
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable

type DateTimeOffset = struct
    interface IFormattable
    interface IParsable<DateTimeOffset>
    interface ISpanFormattable
    interface ISpanParsable<DateTimeOffset>
    interface IDeserializationCallback
    interface ISerializable
    interface IUtf8SpanFormattable

[<System.Serializable>]
type DateTimeOffset = struct
    interface IFormattable
    interface ISerializable
    interface IDeserializationCallback

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

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset), IUtf8SpanFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IFormattable, ISerializable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), ISerializable, ISpanFormattable

Public Structure DateTimeOffset
Implements IComparable, IComparable(Of DateTimeOffset), IDeserializationCallback, IEquatable(Of DateTimeOffset), IParsable(Of DateTimeOffset), ISerializable, ISpanFormattable, ISpanParsable(Of DateTimeOffset)

Herança

Object

ValueType

DateTimeOffset

Atributos

SerializableAttribute

Implementações

IComparable IComparable<DateTimeOffset> IEquatable<DateTimeOffset> IFormattable IParsable<DateTimeOffset> IParsable<TSelf> ISpanFormattable ISpanParsable<DateTimeOffset> IUtf8SpanFormattable IDeserializationCallback ISerializable

Comentários

A DateTimeOffset estrutura inclui um DateTime valor, juntamente com uma Offset propriedade que define a diferença entre a data e a hora da instância atual DateTimeOffset e o UTC (Tempo Universal Coordenado). Como define exatamente uma data e hora relativas ao UTC, a DateTimeOffset estrutura não inclui um Kind membro, como a DateTime estrutura faz. Ele representa datas e horários com valores cuja UTC varia de 12:00:00 meia-noite, 1º de janeiro de 0001 Anno Domini (Common Era), às 23:59:59, 31 de dezembro de 9999 D.C. (C.E.).

O componente de hora de um DateTimeOffset valor é medido em unidades de 100 nanossegundos chamadas tiques, e uma data específica é o número de tiques desde 12:00 meia-noite, 1º de janeiro de 0001 D.C. (C.E.) no GregorianCalendar calendário. Um DateTimeOffset valor é sempre expresso no contexto de um calendário explícito ou padrão. Os tiques atribuíveis a segundos bissextos não são incluídos no número total de tiques.

Embora um DateTimeOffset valor inclua um deslocamento, ele não é uma estrutura de dados totalmente com reconhecimento de fuso horário. Embora um deslocamento de UTC seja uma característica de um fuso horário, ele não identifica de forma inequívoca um fuso horário. Não apenas vários fusos horários compartilham o mesmo deslocamento de UTC, mas o deslocamento de um único fuso horário muda se ele observa o horário de verão. Isso significa que, assim que um DateTimeOffset valor é desassociado de seu fuso horário, ele não pode mais ser inequívocamente vinculado de volta ao fuso horário original.

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 membros. Isso significa que sua DateTime propriedade está definida DateTimeOffset.MinValue e sua Offset propriedade está definida como TimeSpan.Zero.

Você pode criar um novo DateTimeOffset valor chamando qualquer uma das sobrecargas de seu construtor, que são semelhantes aos construtores sobrecarregados para a DateTime estrutura. Você também pode criar um novo DateTimeOffset valor atribuindo-lhe um DateTime valor. Esta é uma conversão implícita; ele não requer um operador de conversão (em C#) ou uma chamada para um método de conversão (no Visual Basic). Você também pode inicializar um DateTimeOffset valor da representação de cadeia de caracteres de uma data e hora chamando vários métodos de análise de cadeia de caracteres estáticos, que incluem Parse, ParseExact, TryParsee TryParseExact.

Os membros da DateTimeOffset estrutura fornecem funcionalidade nas seguintes áreas:

• Aritmética de data e hora.

  Você pode adicionar ou subtrair datas ou intervalos de tempo de um valor específico DateTimeOffset . Operações aritméticas com DateTimeOffset valores, ao contrário daqueles com DateTime valores, ajustam-se para diferenças nos deslocamentos de tempo ao retornar um resultado. Por exemplo, o código a seguir usa DateTime variáveis para subtrair a hora local atual da hora UTC atual. Em seguida, o código usa variáveis DateTimeOffset para executar a mesma operação. A subtração com DateTime valores retorna a diferença do fuso horário local de UTC, enquanto a subtração com DateTimeOffset valores retorna 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
     }
  }
  

  open System
  
  // Find difference between Date.Now and Date.UtcNow
  let date1 = DateTime.Now
  let date2 = DateTime.UtcNow
  let difference1 = date1 - date2
  printfn $"{date1} - {date2} = {difference1}"
  
  // Find difference between Now and UtcNow using DateTimeOffset
  let dateOffset1 = DateTimeOffset.Now
  let dateOffset2 = DateTimeOffset.UtcNow
  let difference2 = dateOffset1 - dateOffset2
  printfn $"{dateOffset1} - {dateOffset2} = {difference2}"
                   
  // If run in the Pacific Standard time zone on 1/7/2022, the example
  // displays the following output to the console:
  //    1/7/2022 6:45:10 PM - 1/8/2022 2:45:10 AM = -08:00:00.0072573
  //    1/7/2022 6:45:10 PM -08:00 - 1/8/2022 2:45:10 AM +00:00 = -00:00:00.0000278
  

  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.

  Você pode converter DateTimeOffset valores em DateTime valores e vice-versa.

• Operações de manipulação e extração de tempo.

  Você pode extrair a data ou a hora de um DateTimeOffset valor. Você também pode recuperar o valor de um componente específico DateTimeOffset , como seu ano ou seu mês.

  Observação

  Se você estiver trabalhando com um valor de tiques que deseja converter em algum outro intervalo de tempo, como minutos ou segundos, deverá usar a TimeSpan.TicksPerDay, TimeSpan.TicksPerHour, , TimeSpan.TicksPerMinuteTimeSpan.TicksPerSecondou TimeSpan.TicksPerMillisecond constante para executar a conversão. Por exemplo, para adicionar o número de segundos representado por um número especificado de tiques ao componente Second de um valor DateTimeOffset, você pode usar a expressão dateValue.Second + nTicks/Timespan.TicksPerSecond.

• Conversão de data e hora.

  Você pode converter qualquer DateTimeOffset valor em outro DateTimeOffset valor que represente o mesmo ponto no tempo em outro fuso horário. No entanto, as regras de ajuste de um fuso horário são aplicadas somente no caso do ToLocalTime método, que converte um DateTimeOffset valor na data e hora na zona do sistema local.

• Comparação de data e hora.

  Você pode determinar se qualquer valor específico DateTimeOffset é anterior, o mesmo que ou posterior a outro DateTimeOffset valor. Antes que a comparação seja executada, todos os valores são convertidos em UTC.

Confira também

• Escolhendo entre DateTime, DateTimeOffset, TimeSpan e TimeZoneInfo
• Exemplo de : Utilitário de Formatação do WinForms do .NET Core (C#)
• Exemplo de : Utilitário de Formatação winforms do .NET Core (Visual Basic)