DateTimeOffset.AddTicks(Int64) Método

Definição

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.

public:
 DateTimeOffset AddTicks(long ticks);
public DateTimeOffset AddTicks (long ticks);
member this.AddTicks : int64 -> DateTimeOffset
Public Function AddTicks (ticks As Long) As DateTimeOffset

Parâmetros

ticks
Int64

Um número de tiques de 100 nanossegundos.A number of 100-nanosecond ticks. O número pode ser positivo ou negativo.The number can be negative or positive.

Retornos

DateTimeOffset

Um objeto cujo valor é a soma da data e hora representada pelo objeto DateTimeOffset atual e o número de tiques representado por ticks.An object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of ticks represented by ticks.

Exceções

O valor DateTimeOffset resultante é menor que MinValue.The resulting DateTimeOffset value is less than MinValue.

- ou --or- O valor DateTimeOffset resultante é maior que MaxValue.The resulting DateTimeOffset value is greater than MaxValue.

Comentários

Uma escala representa 100 nanossegundos ou um-dez milionésimo de um segundo.A tick represents 100 nanoseconds, or one-ten millionth of a second. Como um tique é um intervalo de tempo muito pequeno e preciso, qualquer unidade de tempo maior pode ser expressa como um número de tiques sem perda de precisão.Because a tick is a very small and precise time interval, any larger time unit can be expressed as a number of ticks without a loss of precision.

Observação

Este método retorna um novo objeto DateTimeOffset.This method returns a new DateTimeOffset object. Ele não modifica o valor do objeto atual adicionando minutes à sua data e hora.It does not modify the value of the current object by adding minutes to its date and time.

A tabela a seguir lista o número de tiques em um intervalo de tempo específico.The following table lists the number of ticks in a particular time interval.

Intervalo de tempoTime interval Número de tiquesNumber of ticks
SegundoSecond 10 milhões10,000,000
MinutoMinute 600 milhões600,000,000
HoraHour 36.000.000.00036,000,000,000
DiaDay 864.000.000.000864,000,000,000
SemanaWeek 6.048.000.000.0006,048,000,000,000
MêsMonth Depende do número de dias do mês.Depends on number of days in the month.
Ano não bissextoNon-leap year 315.360.000.000.000315,360,000,000,000
Ano bissextoLeap year 316.224.000.000.000316,224,000,000,000

Como um DateTimeOffset objeto não representa a data e a hora em um fuso horário específico, o AddTicks método não considera as regras de ajuste de um fuso horário específico quando ele executa a aritmética de data e hora.Because a DateTimeOffset object does not represent the date and time in a specific time zone, the AddTicks method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.

Aplica-se a