Compartilhar via

Alteração de formatação do DateTimeOffset em System.Formats.Cbor

Desde que foi lançado no .NET 5, o pacote NuGet System.Formats.Cbor incluiu métodos internos para serializar e desserializar valores DateTimeOffset de acordo com o RFC 7049. Infelizmente, as implementações não usaram cultura invariável ao formatar e analisar valores DateTimeOffset. Isso resultou em codificações de data inconsistentes ou até incorretas em computadores com culturas que usam calendários não gregorianos.

O comportamento foi alterado para que a cultura invariável seja sempre usada ao analisar e formatar valores DateTimeOffset. Essa alteração poderá quebrar seu código se você se basear no comportamento anterior. Além disso, pode ser impossível ler valores de data codificados com versões anteriores do pacote NuGet System.Formats.Cbor.

Versão introduzida

.NET 8

Comportamento anterior

Considere este código que analisa um valor DateTimeOffset de uma cadeia de caracteres e, em seguida, codifica-o usando CBOR:

// Install a culture with a non-Gregorian calendar
var culture = new CultureInfo("he-IL");
culture.DateTimeFormat.Calendar = new HebrewCalendar();
Thread.CurrentThread.CurrentCulture = culture;

DateTimeOffset value = DateTimeOffset.Parse("2020-04-09T14:31:21.3535941+01:00", CultureInfo.InvariantCulture);

var writer = new CborWriter();
writer.WriteDateTimeOffset(value);
byte[] cborEncoding = writer.Encode();

Console.WriteLine(Convert.ToHexString(cborEncoding));

Anteriormente, esse código produzia a seguinte codificação CBOR:

C07828D7AAD7A922D7A42DD796272DD79822D7955431343A33313A32312E333533353934312B30313A3030

Essa codificação corresponde à 0(תש\"פ-ז'-ט\"וT14:31:21.3535941+01:00), na notação de diagnóstico CBOR, que é uma representação de data inválida de acordo com a RFC 7049.

Novo comportamento

A partir do .NET 8, o mesmo código produz a seguinte codificação CBOR:

C07821323032302D30342D30395431343A33313A32312E333533353934312B30313A3030

Essa codificação corresponde à notação de diagnóstico CBOR 0("2020-04-09T14:31:21.3535941+01:00").

Tipo de mudança disruptiva

Esta é uma alteração comportamental.

Motivo da alteração

O comportamento anterior produziu codificações de data inválidas por RFC 7049.

Talvez seja necessário conseguir ler codificações de data CBOR que foram persistidas usando versões anteriores do System.Formats.Cbor, caso você não atualize para a versão mais recente do pacote NuGet System.Formats.Cbor.

Como alternativa, você pode alterar seu código para usar o seguinte método de extensão:

public static class CborReaderExtensions
{
    private const string Rfc3339FormatString = "yyyy-MM-ddTHH:mm:ss.FFFFFFFK";

    public static DateTimeOffset ReadDateTimeOffsetReplacement(this CborReader reader, CultureInfo? cultureInfo = null)
    {
        CborTag tag = reader.PeekTag();
        if (tag != CborTag.DateTimeString)
        {
            throw new InvalidOperationException($"Expected CborTag {(int)CborTag.DateTimeString}");
        }

        reader.ReadTag();
        string dateString = reader.ReadTextString();
        return DateTimeOffset.ParseExact(dateString, Rfc3339FormatString, cultureInfo, DateTimeStyles.    RoundtripKind);
    }
}

Use este método de extensão para ler uma codificação de data CBOR da seguinte maneira:

var reader = new CborReader(cborEncoding);
DateTimeOffset date = reader.ReadDateTimeOffsetReplacement(culture);
Console.WriteLine(date.ToString(CultureInfo.InvariantCulture));

APIs afetadas

  • Last updated on