DateTimeOffset.AddTicks(Int64) Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs
Origem:
DateTimeOffset.cs

Retorna um novo objeto DateTimeOffset que adiciona um número especificado de tiques ao valor dessa instância.

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. O número pode ser positivo ou negativo.

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.

Exceções

ArgumentOutOfRangeException

O valor resultante DateTimeOffset é menor que DateTimeOffset.MinValue.

-ou-

O valor resultante DateTimeOffset é maior que DateTimeOffset.MaxValue.

Comentários

Um carrapato representa 100 nanossegundos, ou um décimo milionésimo de segundo. 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.

Observação

Este método retorna um novo objeto DateTimeOffset. Ele não modifica o valor do objeto atual adicionando ticks à sua data e hora.

A tabela a seguir lista o número de tiques em um intervalo de tempo específico.

Intervalo de tempo Número de tiques
Segundo 10.000.000
Minuto 600,000,000
Hora 36,000,000,000
Dia 864,000,000,000
Semana 6,048,000,000,000
Mês Depende do número de dias no mês.
Ano não bissexto 315,360,000,000,000
Ano bissexto 316,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 regras de ajuste de um fuso horário específico quando executa aritmética de data e hora.

Aplica-se a

Confira também