Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

System.DateTimeOffset: referência prática

System.DateTimeOffset: referência prática: DateTimeOffset combina uma hora com um desvio e assim identifica um instante inequívoco.

Versão: .NET API; verified on .NET 10.0.14

Sintaxe

System.DateTimeOffset /* select a documented member or constructor */

DateTimeOffset combina uma hora com um desvio e assim identifica um instante inequívoco.

Usa-o para timestamps trocados entre sistemas, preservando o desvio observado.

Um desvio não é um identificador de fuso nem conserva as regras históricas de horário de verão.

Tem de ficar entre menos e mais catorze horas em minutos inteiros e o instante UTC resultante tem de ser válido.

O programa completo usa realmente System.DateTimeOffset; o stdout exato esperado é +01:00.

Exemplos

using System;
using System.Buffers;
using System.Collections.Concurrent;
using System.Collections.Frozen;
using System.Collections.Generic;
using System.Collections.Immutable;
using System.Diagnostics;
using System.Globalization;
using System.IO;
using System.Linq;
using System.Linq.Expressions;
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
using System.Text;
using System.Text.Json;
using System.Text.Json.Nodes;
using System.Text.Json.Serialization;
using System.Text.RegularExpressions;
using System.Threading;
using System.Threading.Channels;
using System.Threading.Tasks;
using Number = System.Int32;

var instant = new DateTimeOffset(2026, 11, 17, 12, 0, 0, TimeSpan.FromHours(1));
Console.WriteLine(instant.ToString("zzz", CultureInfo.InvariantCulture));

Resultado

+01:00

O programa completo usa realmente `System.DateTimeOffset`; o stdout exato esperado é `+01:00`.

Fontes