Формат DateTime в C#: стандартные и пользовательские форматы, культура, ISO 8601

DateTime.ToString(format) превращает дату в текст. Формат это либо стандартная строка формата (одна буква, например d или o, точный шаблон которой берётся из культуры), либо пользовательский шаблон из спецификаторов вроде yyyy, MM и HH. Те же строки работают в интерполяции, $"{date:yyyy-MM-dd}", и в string.Format.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var shipped = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(shipped.ToString("yyyy-MM-dd", inv));
        Console.WriteLine(shipped.ToString("yyyy-MM-dd HH:mm:ss", inv));
        Console.WriteLine(shipped.ToString("dd/MM/yyyy", inv));
        Console.WriteLine(shipped.ToString("MMM d, yyyy", inv));
        Console.WriteLine(shipped.ToString("dddd, MMMM d", inv));
        Console.WriteLine(shipped.ToString("h:mm tt", inv));
        Console.WriteLine(shipped.ToString("HH:mm:ss.fff", inv));
        Console.WriteLine($"Shipped {shipped:yyyy-MM-dd} at {shipped:HH:mm}");
    }
}

Вывод:

2026-10-09
2026-10-09 18:30:07
09/10/2026
Oct 9, 2026
Friday, October 9
6:30 PM
18:30:07.045
Shipped 2026-10-09 at 18:30

Примеры на этой странице передают CultureInfo.InvariantCulture, чтобы вывод был одинаковым на любой машине; без неё ToString использует текущую культуру, которая может поменять названия месяцев, разделители и даже календарь.

Пользовательские спецификаторы формата

Пользовательский формат это шаблон, в котором определённые буквы обозначают части даты. Они чувствительны к регистру: M это месяц, а m минуты, H это часы в 24-часовом формате, а h в 12-часовом.

Любой другой символ копируется как есть. Это касается и букв, которые не являются спецификаторами, поэтому "YYYY-DD" молча печатает YYYY-DD: в .NET нет спецификаторов Y и D в верхнем регистре.

Одна буква сама по себе читается как стандартный формат, а не пользовательский: ToString("d") это шаблон короткой даты, а не номер дня. Чтобы получить только день, пишите ToString("%d") или используйте свойство Day.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(d.ToString("d", inv));             // standard short date
        Console.WriteLine(d.ToString("%d", inv));            // custom: day of month
        Console.WriteLine(d.ToString("yyyyMMdd_HHmmss", inv)); // for file names
        Console.WriteLine(d.ToString("'Week of' MMM d", inv));
        Console.WriteLine(d.ToString("HH'h'mm", inv));
        Console.WriteLine(d.ToString("yyyy-MM-ddTHH:mm:ss", inv));
        Console.WriteLine(d.ToString("YYYY-DD", inv));      // not specifiers: copied
    }
}

Вывод:

10/09/2026
9
20261009_183007
Week of Oct 9
18h30
2026-10-09T18:30:07
YYYY-DD

Стандартные строки формата

Стандартные форматы это одиночные буквы, фактический шаблон которых определяет культура. Это правильный выбор для текста, который видят пользователи, потому что каждая культура бесплатно получает свои соглашения.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7, DateTimeKind.Utc);
        var inv = CultureInfo.InvariantCulture;

        foreach (string f in new[] { "d", "D", "f", "g", "G", "M", "Y", "t", "T", "o", "s", "u", "r" })
        {
            Console.WriteLine($"{f}  {d.ToString(f, inv)}");
        }

        var us = new CultureInfo("en-US");
        Console.WriteLine($"en-US d: {d.ToString("d", us)}, D: {d.ToString("D", us)}");
    }
}

Вывод:

d  10/09/2026
D  Friday, 09 October 2026
f  Friday, 09 October 2026 18:30
g  10/09/2026 18:30
G  10/09/2026 18:30:07
M  October 09
Y  2026 October
t  18:30
T  18:30:07
o  2026-10-09T18:30:07.0000000Z
s  2026-10-09T18:30:07
u  2026-10-09 18:30:07Z
r  Fri, 09 Oct 2026 18:30:07 GMT
en-US d: 10/9/2026, D: Friday, October 9, 2026

o, s, u и r дают одинаковый текст в любой культуре, поэтому их безопасно использовать для логов, имён файлов и обмена данными. Учтите, что для DateTime форматы u и r не переводят значение в UTC; они печатают его как есть и помечают как UTC, поэтому если значение локальное, сначала вызовите ToUniversalTime() (или используйте DateTime.UtcNow). (Для DateTimeOffset преобразование выполняется.)

Культура меняет вывод

Стандартные форматы, названия месяцев и дней, а также разделители / и : берутся из культуры. Передайте её вторым аргументом в ToString:

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 0);
        string[] cultures = { "en-US", "en-GB", "de-DE", "fr-FR", "ja-JP" };

        foreach (string name in cultures)
        {
            var c = new CultureInfo(name);
            Console.WriteLine($"{name}  {d.ToString("d", c)}");
        }

        var de = new CultureInfo("de-DE");
        Console.WriteLine(d.ToString("D", de));
        Console.WriteLine(d.ToString("D", new CultureInfo("fr-FR")));
        Console.WriteLine(d.ToString("dd/MM/yyyy", de));      // "/" becomes "."
        Console.WriteLine(d.ToString("dd'/'MM'/'yyyy", de));  // quoted: a real slash
    }
}

Вывод:

en-US  10/9/2026
en-GB  09/10/2026
de-DE  09.10.2026
fr-FR  09/10/2026
ja-JP  2026/10/09
Freitag, 9. Oktober 2026
vendredi 9 octobre 2026
09.10.2026
09/10/2026

Данные культур не заморожены. .NET в Linux и macOS читает их из библиотеки ICU, установленной в системе, а начиная с .NET 5 так же делает .NET в Windows 10 и новее (.NET Framework использует собственные данные NLS Windows), поэтому шаблон может немного меняться между версиями и платформами: например, свежие выпуски ICU ставят перед «PM» в американском формате короткого времени узкий неразрывный пробел вместо обычного, а некоторые дают испанские короткие даты без ведущего нуля. Это ещё одна причина никогда не разбирать текст, отформатированный для отображения.

Отсюда два правила. Для текста, который читает человек, форматируйте с его культурой (на сервере с культурой из запроса, а не сервера) и предпочитайте стандартные форматы, чтобы немецкий читатель видел 09.10.2026, а американский 10/9/2026. Для текста, который читает программа, используйте CultureInfo.InvariantCulture и однозначный шаблон вроде yyyy-MM-dd или o. Дата, записанная с текущей культурой и разобранная на другой машине, это классический источник перепутанных дней и месяцев.

ISO 8601 и обратный разбор с «o»

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

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var inv = CultureInfo.InvariantCulture;
        var utc = new DateTime(2026, 10, 9, 18, 30, 7, 45, DateTimeKind.Utc);
        var unspecified = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var offset = new DateTimeOffset(2026, 10, 9, 20, 30, 7, TimeSpan.FromHours(2));

        string stored = utc.ToString("o", inv);
        Console.WriteLine(stored);
        Console.WriteLine(unspecified.ToString("o", inv));
        Console.WriteLine(offset.ToString("o", inv));

        DateTime back = DateTime.Parse(stored, inv, DateTimeStyles.RoundtripKind);
        Console.WriteLine(back == utc);
        Console.WriteLine(back.Kind);

        Console.WriteLine(utc.ToString("yyyy-MM-ddTHH:mm:ssK", inv));    // no fractions
        Console.WriteLine(offset.ToString("yyyy-MM-dd HH:mm zzz", inv));
    }
}

Вывод:

2026-10-09T18:30:07.0450000Z
2026-10-09T18:30:07.0450000
2026-10-09T20:30:07.0000000+02:00
True
Utc
2026-10-09T18:30:07Z
2026-10-09 20:30 +02:00

Суффикс Z обозначает UTC; DateTime с Kind, равным Unspecified, суффикса не получает; локальное время или DateTimeOffset получает своё смещение (+02:00). Разбирайте с DateTimeStyles.RoundtripKind, чтобы Kind сохранился. Этот формат читают JSON-сериализаторы, базы данных и Date в JavaScript.

Форматирование TimeSpan

У TimeSpan свой, меньший набор пользовательских спецификаторов: d (дни), hh, mm, ss и fff. В отличие от DateTime, каждый буквальный символ, включая : и ., нужно экранировать обратным слешем или заключать в кавычки:

using System;

class Program
{
    static void Main()
    {
        var elapsed = new TimeSpan(1, 3, 25, 9, 120);   // 1 day 3:25:09.120

        Console.WriteLine(elapsed.ToString());
        Console.WriteLine(elapsed.ToString("c"));
        Console.WriteLine(elapsed.ToString(@"hh\:mm\:ss"));        // hours component only
        Console.WriteLine(elapsed.ToString(@"d\.hh\:mm"));
        Console.WriteLine(elapsed.ToString(@"mm\:ss\.fff"));
        Console.WriteLine($"{(int)elapsed.TotalHours}:{elapsed.Minutes:D2}");  // 27:25
    }
}

Вывод:

1.03:25:09.1200000
1.03:25:09.1200000
03:25:09
1.03:25
25:09.120
27:25

hh в формате TimeSpan это компонент часов (от 0 до 23), поэтому длительность в 27 часов печатается как 03. Для итогов больше суток вычисляйте из TotalHours, как в последней строке. elapsed.ToString("hh:mm") без обратного слеша выбрасывает FormatException.

Частые ошибки

• mm вместо месяца. "yyyy-mm-dd" печатает минуты посередине: 2026-30-09. Месяц это MM.
• hh без tt. "hh:mm" это 12-часовой формат без AM и PM, поэтому 06:30 неоднозначно. Для 24-часового времени используйте HH.
• YYYY и DD. В .NET это не спецификаторы; они печатаются буквально. Используйте yyyy и dd.
• / в шаблоне для данных. Это разделитель даты культуры. Заключите его в кавычки или используйте инвариантную культуру.
• ToString() по умолчанию в логах или файлах. Формат зависит от машины. Передавайте формат и культуру.
• Локальное время с пометкой UTC. "u", "r" и написанная вручную 'Z' не преобразуют значение; сначала преобразуйте.
• Разбор по другому шаблону, чем при записи. Храните строки формата для данных в одной константе и используйте её и с ToString, и с ParseExact.