Форматирование даты и времени в C#

Для преобразования значения DateTime в строковое значение в C# может использоваться методToString, который, в свою очередь, может принимать в качестве входных параметров различные описатели форматов. Сегодня мы рассмотрим более подробно форматирование даты и времени в C#.

Строки стандартных форматов даты и времени в C#

Строка стандартного формата даты и времени — это специальная строка, состоящая из одного символа и применяемая для форматирования даты/времени в строковое значение в соответствии с заданным форматом.

Строка стандартного формата содержит всегда один символ. Если вы попытаетесь передать в качестве формата два и более символа, то C# интерпретирует такую строку как пользовательский формат даты/времени.  В таблице ниже представлены стандартные форматы даты и времени, которые вы можете использовать в C#.

Следует отметить, что на итоговое строковое значение даты и времени в C# также оказывают влияние и региональные настройки. Например, воспользуемся коротким шаблоном даты и выведем строковое значение даты для русской (ru-RU) и, например, английской локали (en-US). Для этого воспользуемся перегруженным методом ToString(), который в качестве второго параметра принимает значение CultureInfo:

Console.WriteLine($"ru-RU: {dateTime.ToString("d", CultureInfo.GetCultureInfo("ru-RU"))}");
Console.WriteLine($"en-US: {dateTime.ToString("d", CultureInfo.GetCultureInfo("en-US"))}");

В консоли мы получим следующий вывод:

Настраиваемые форматы даты и времени в C#

Не всегда удобно использовать какие-либо стандартные форматы даты и времени. Например, при разработки Web API вам может потребоваться, чтобы дата/время передавались в ваше метод в строго определенном формате, который будет отличен от всех имеющихся стандартных форматов (например, строка даты не должна содержать ничего кроме чисел). В этом случае, нам необходимо использовать настраиваемые форматы даты/времени в C#.

В следующей таблице приведены настраиваемые описатели формата даты и времени с примерами строк, формируемых каждым описателем формата. По умолчанию результирующие строки отражают соглашения о форматировании для языка и региональных параметров en-US. Если конкретный описатель формата создает локализованную строку, то в примере также указываются язык и региональные параметры, для которых применяется полученная строка. Дополнительные сведения об использовании настраиваемых строк формата даты и времени см. в подразделе Примечания.

Используя различные сочетания описателей формата, мы можем форматировать дату и время в C# так, как нам это необходимо. Например,

Console.WriteLine($"{dateTime.ToString("Месяц: MM число: dd день недели: dddd")}");
Console.WriteLine($"{dateTime.ToString("ddMMyyyy")}");

Результат:

Можно заметить, что часть настраиваемых форматов даты и времени совпадает с аналогичными стандартными форматами, например, формат «d«. В этом случае, если вы хотите указать d именно, как пользовательский формат, то необходимо использовать в строке формата символ %:

Console.WriteLine($"{dateTime.ToString("d")}");
Console.WriteLine($"{dateTime.ToString("%d")}");

В первом случае мы использовали стандартный формат, а во втором — пользовательский:

Итого

Для представления строкового значения даты времени (форматирования даты и времени) в C# используется метод ToString, который в качестве параметров может принимать как стандартные, так и пользовательские форматы даты и времени в C#. Также, в метод ToString можно передавать дополнительные параметры и форматировать дату и время, используя различные региональные настройки, отличные от используемых по умолчанию.