Class DateTimeExtensions

Namespace: Cuemon.Extensions.Xml

Assembly: Cuemon.Extensions.Xml.dll

Extension methods for the DateTime struct.

public static class DateTimeExtensions

Inheritance: object

DateTimeExtensions

Examples

DateTimeExtensions in the Xml namespace formats DateTime values as XML strings using XmlDateTimeSerializationMode enum values. This example creates DateTime.UtcNow and DateTime.Now, then calls ToString with XmlDateTimeSerializationMode.Utc (appends Z), Local (includes timezone offset like +02:00), RoundtripKind (preserves Kind information), and Unspecified (omits timezone info). Console output for each mode shows how time zone information is represented or omitted, such as 2026-06-16T12:34:56.789Z for UTC and 2026-06-16T14:34:56.789+02:00 for local.

using System;
using System.Xml;
using Cuemon.Extensions.Xml;

namespace MyApp.Xml
{
    public class DateTimeExtensionsExample
    {
        public void Demonstrate()
        {
            DateTime utcNow = DateTime.UtcNow;

            // Format as XML UTC string (appends "Z" for UTC)
            string xmlUtc = utcNow.ToString(XmlDateTimeSerializationMode.Utc);
            Console.WriteLine(xmlUtc);
            // Output: 2026-06-16T12:34:56.789Z

            // Convert local time to XML local string (includes offset)
            DateTime localNow = DateTime.Now;
            string xmlLocal = localNow.ToString(XmlDateTimeSerializationMode.Local);
            Console.WriteLine(xmlLocal);
            // Output: 2026-06-16T14:34:56.789+02:00

            // Round-trip format preserves the Kind information
            string xmlRoundtrip = utcNow.ToString(XmlDateTimeSerializationMode.RoundtripKind);
            Console.WriteLine(xmlRoundtrip);
            // Output: 2026-06-16T12:34:56.789Z

            // Unspecified mode drops any time zone info
            string xmlUnspecified = utcNow.ToString(XmlDateTimeSerializationMode.Unspecified);
            Console.WriteLine(xmlUnspecified);
            // Output: 2026-06-16T12:34:56.789

}}
}

Methods

ToString(DateTime, XmlDateTimeSerializationMode)

Converts the specified value to a string using the serializationMode specified.

public static string ToString(this DateTime value, XmlDateTimeSerializationMode serializationMode)

Parameters

value DateTime: The DateTime value to convert.
serializationMode XmlDateTimeSerializationMode: One of the XmlDateTimeSerializationMode values that specify how to treat the DateTime value.

Returns