Why DateTime.ParseExact(String, String, IFormatProvider) need the IFormatProvider?

Yair Nevet picture Yair Nevet · Sep 23, 2013 · Viewed 66.7k times · Source

If we're using the ParseExact method for exact date-time's parsing using a specified format, why do we need to provide a IFormatProvider object? what is the point behind it?

For example:

DateTime.ParseExact(dateString, format, provider);

Why do we need the provider here?

Answer

Jon Skeet picture Jon Skeet · Sep 23, 2013

why do we need to provide a IFormatProvider object? what is the point behind it?

It allows for culture-specific options. In particular:

  • The format you use could be a standard date/time format, which means different patterns in different cultures
  • You could use : or / in your pattern, which mean culture-specific characters for the time separator or date separator respectively
  • When parsing month and day names, those clearly depend on culture
  • The culture determines the default calendar as well, which will affect the result

As an example of the last point, consider the same exact string and format, interpreted in the culture of the US or Saudi Arabia:

using System;
using System.Globalization;

class Test
{
    static void Main()        
    {
        CultureInfo us = new CultureInfo("en-US");
        CultureInfo sa = new CultureInfo("ar-SA");
        string text = "1434-09-23T15:16";
        string format = "yyyy'-'MM'-'dd'T'HH':'mm";
        Console.WriteLine(DateTime.ParseExact(text, format, us));
        Console.WriteLine(DateTime.ParseExact(text, format, sa));
    }
} 

When parsing with the US culture, the Gregorian calendar is used - whereas when parsing with the Saudi Arabian culture, the Um Al Qura calendar is used, where 1434 is the year we're currently in (as I write this answer).