How to parse and generate DateTime objects in ISO 8601 format

by

The format you’re describing is ISO 8601.

Since you’re working with timestamps that inclulde a time zone component, I’d strongly recommend using DateTimeOffset instead of DateTime. It makes things so much easier!

To create a DateTimeOffset for a given date, time, and time zone offset, use this syntax:

var date = new DateTimeOffset(2016, 3, 29, 12, 20, 35, 93, TimeSpan.FromHours(-5));
// March 29, 2016 at 12:20:35.93 GMT-5

This code will format a DateTimeOffset as ISO 8601:

public static string FormatIso8601(DateTimeOffset dto)
{
    string format = dto.Offset == TimeSpan.Zero
        ? "yyyy-MM-ddTHH:mm:ss.fffZ"
        : "yyyy-MM-ddTHH:mm:ss.fffzzz";

    return dto.ToString(format, CultureInfo.InvariantCulture);
}

And, to parse a string back to a DateTimeOffset:

public static DateTimeOffset ParseIso8601(string iso8601String)
{
    return DateTimeOffset.ParseExact(
        iso8601String,
        new string[] { "yyyy-MM-dd'T'HH:mm:ss.FFFK" },
        CultureInfo.InvariantCulture,
        DateTimeStyles.None);
}

If you must get back to a DateTime you can get this from the DateTimeOffset.UtcDateTime property.

More Related Contents:

  1. How to create a .NET DateTime from ISO 8601 format
  2. How do I calculate someone’s age based on a DateTime type birthday?
  3. DateTime vs DateTimeOffset
  4. Parse DateTime with time zone of form PST/CEST/UTC/etc
  5. Algorithm to detect overlapping periods [duplicate]
  6. C# DateTime.Now precision
  7. How to get difference between two dates in Year/Month/Week/Day?
  8. format date in c#
  9. How do I get the last day of a month?
  10. What does “DateTime?” mean in C#?
  11. Measuring code execution time
  12. Environment.TickCount vs DateTime.Now
  13. Why DateTime.AddHours doesn’t seem to work?
  14. How to convert Javascript datetime to C# datetime?
  15. How to find the 3rd Friday in a month with C#?
  16. Parse C# string to DateTime
  17. DateTime ToString issue with formatting months with “mm” specifier
  18. why does DateTime.ToString(“dd/MM/yyyy”) give me dd-MM-yyyy?
  19. How to ensure a timestamp is always unique?
  20. How can I format DateTime to web UTC format?
  21. datetime to string with time zone
  22. How frequent is DateTime.Now updated ? or is there a more precise API to get the current time?
  23. Convert String to Date in .NET if my incoming date format is in YYYYMMDD
  24. DateTime conversion from string C#
  25. DateTime.Parse(“2012-09-30T23:00:00.0000000Z”) always converts to DateTimeKind.Local
  26. Getting the first and last day of a month, using a given DateTime object
  27. Days, hours, minutes, seconds between two dates
  28. How to check if a DateTime occurs today?
  29. Convert DateTime to long and also the other way around
  30. .NET DateTime to SqlDateTime Conversion

Leave a Comment