Бөлісу құралы:

dateTimeInvalidLocalFormat MDA

Примечание.

Эта статья относится к .NET Framework. Он не применяется к более новым реализациям .NET, включая .NET 6 и более поздние версии.

Помощник по отладке управляемого кода dateTimeInvalidLocalFormat активируется в том случае, если экземпляр DateTime, который хранится в формате времени UTC, форматируется с использованием формата, предназначенного только для локальных экземпляров DateTime. Этот помощник не активируется в том случае, если экземпляры DateTime не заданы или заданы по умолчанию.

Симптом

Приложение вручную сериализует экземпляр DateTime в формате UTC с использованием локального формата:

DateTime myDateTime = DateTime.UtcNow;
Serialize(myDateTime.ToString("yyyy-MM-dd'T'HH:mm:ss.fffffffzzz"));

Причина

Формат "z" для метода DateTime.ToString включает сдвиг местного часового пояса, например "+03:00" для московского времени. Таким образом, значащий результат будет получен только в том случае, если экземпляр DateTime содержит значение местного времени. Если время указано в формате UTC, DateTime.ToString содержит сдвиг местного часового пояса, однако не отображает и не позволяет изменять описатель часового пояса.

Разрешение

Экземпляры DateTime в формате UTC должны иметь форматирование, явно указывающее на это. Для работы со временем в формате UTC рекомендуется использовать формат "Z":

DateTime myDateTime = DateTime.UtcNow;
Serialize(myDateTime.ToString("yyyy-MM-dd'T'HH:mm:ss.fffffffZ"));

Также доступен формат "o", который сериализует DateTime с использованием свойства Kind и обеспечивает корректную сериализацию независимо от того, содержит экземпляр местное время, время в формате UTC или формат не указан:

DateTime myDateTime = DateTime.UtcNow;
Serialize(myDateTime.ToString("o"));

Влияние на среду выполнения

Этот помощник по отладке управляемого кода не влияет на среду выполнения.

Выходные данные

В результате его активации не возвращаются какие-либо конкретные выходные данные. Тем не менее с помощью стека вызовов можно определить расположение вызова ToString, который стал причиной активации этого помощника.

Настройка

<mdaConfig>
  <assistants>
    <dateTimeInvalidLocalFormat />
  </assistants>
</mdaConfig>

Пример

Рассмотрите возможность косвенной сериализации значений DateTime в формате UTC с использованием класса XmlConvert или DataSet, как показано ниже.

DateTime myDateTime = DateTime.UtcNow;
String serialized = XMLConvert.ToString(myDateTime);

В сериализациях XmlConvert и DataSet по умолчанию используется локальный формат. Для сериализации значений DateTime другого вида, например в формате UTC, требуется указать дополнительные параметры.

Конкретно в этом примере необходимо передать XmlDateTimeSerializationMode.RoundtripKind в вызов ToString для XmlConvert. В этом случае данные сериализуются как время в формате UTC.

При использовании DataSet присвойте свойству DateTimeMode объекта DataColumn значение Utc.

DateTime myDateTime = DateTime.UtcNow;
String serialized = XmlConvert.ToString(myDateTime,
    XmlDateTimeSerializationMode.RoundtripKind);

См. также

  • Last updated on