Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

DateTimeOffset Estrutura

Represents a apontar in tempo, geralmente expressed as a Data and tempo of day, relativo to Coordinated Universal Time (UTC).

Namespace:  System
Assembly:  mscorlib (em mscorlib. dll)

[SerializableAttribute]
public struct DateTimeOffset : IComparable, 
	IFormattable, ISerializable, IDeserializationCallback, IComparable<DateTimeOffset>, 
	IEquatable<DateTimeOffset>

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).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 cuja varia UTC de 12: 00: 00 meia-noite, 1 º de janeiro, 0001 C.E., 11:59:59 horas, 31 de dezembro de 9999 C.E.

Although a DateTimeOffset value includes an offset, it is not a fully time zone-aware data structure.Enquanto um deslocamento de UTC é uma característica de um fuso horário, ele não identifica de forma não ambígua um fuso horário.Not only múltiplo compartilhar Zones tempo the same deslocamento from UTC, but the deslocamento of a zona de tempo Single Changes if it observes Daylight Salvando tempo.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.

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.This means that its DateTime property is set to DateTimeOffset.MinValue and its Offset property is set to TimeSpan.Zero.

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.You can also create a new DateTimeOffset value by assigning it a DateTime value.Esta é uma conversão implícita; Ele não exige um operador de elenco (em C#) ou chamar um método de conversão (em Visual Basic).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.

The members of the DateTimeOffset structure provide functionality in the following areas:

  • Data e hora aritmética.

    You can add or subtract either dates or time intervals from a particular DateTimeOffset value.Arithmetic operations with DateTimeOffset values, unlike those with DateTime values, adjust for differences in time offsets when returning a result.For example, the following code uses DateTime variables to subtract the current local time from the current UTC time.The code then uses DateTimeOffset variables to perform the same operation.The subtraction with DateTime values returns the local time zone's difference from UTC, while the subtraction with DateTimeOffset values returns TimeSpan.Zero.

  • tipo Operations conversão.

    You can convert DateTimeOffset values to DateTime values and vice versa.

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

    You can extract either the date or the time of a DateTimeOffset value.You can also retrieve the value of a particular DateTimeOffset component, such as its year or its month.

  • Conversão de data e hora.

    You can convert any DateTimeOffset value to another DateTimeOffset value that represents the same point in time in another time zone.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.

    You can determine whether any particular DateTimeOffset value is earlier than, the same as, or later than another DateTimeOffset value.Before the Comparison is performed, Tudo values are converted to UTC.

Quaisquer membros públicos estático (compartilhados na Visual Basic) desse tipo são Thread seguro. Não há garantia de que qualquer membro de instância seja isento de segmentos.

Contribuições da comunidade

ADICIONAR
Mostrar: