Định dạng DateTime trong C#: chuỗi định dạng, culture, ISO 8601

DateTime.ToString(format) biến một ngày thành văn bản. Định dạng có thể là chuỗi định dạng chuẩn (một chữ cái như d hoặc o, có mẫu cụ thể do culture quyết định) hoặc một mẫu tùy chỉnh ghép từ các ký hiệu định dạng (format specifier) như yyyy, MM và HH. Các chuỗi này cũng dùng được trong chuỗi nội suy, $"{date:yyyy-MM-dd}", và trong 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}");
    }
}

Đầu ra:

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

Các ví dụ trên trang này truyền CultureInfo.InvariantCulture để đầu ra giống nhau trên mọi máy; nếu không có nó, ToString dùng culture hiện tại, có thể làm thay đổi tên tháng, dấu phân cách và thậm chí cả lịch.

Ký hiệu định dạng tùy chỉnh

Định dạng tùy chỉnh là một mẫu trong đó một số chữ cái đại diện cho các phần của ngày. Chúng phân biệt chữ hoa chữ thường: M là tháng còn m là phút, H là giờ dạng 24 giờ còn h là giờ dạng 12 giờ.

Mọi ký tự khác được giữ nguyên. Kể cả những chữ cái không phải ký hiệu định dạng, và đó là lý do "YYYY-DD" lặng lẽ in ra YYYY-DD: .NET không có ký hiệu Y hay D viết hoa.

Một chữ cái đứng riêng được hiểu là định dạng chuẩn, không phải tùy chỉnh: ToString("d") là mẫu ngày dạng ngắn, không phải số ngày. Để chỉ lấy ngày, viết ToString("%d") hoặc dùng property 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
    }
}

Đầu ra:

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

Chuỗi định dạng chuẩn

Định dạng chuẩn là các chữ cái đơn có mẫu thực tế do culture định nghĩa. Chúng là lựa chọn đúng cho văn bản hiển thị cho người dùng, vì mỗi culture tự động có quy ước riêng của mình.

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)}");
    }
}

Đầu ra:

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 và r cho ra cùng một văn bản ở mọi culture, nên an toàn cho log, tên tệp và trao đổi dữ liệu. Lưu ý rằng với DateTime, u và r không chuyển giá trị sang UTC; chúng in nguyên giá trị và gắn nhãn UTC, nên hãy gọi ToUniversalTime() trước (hoặc dùng DateTime.UtcNow) nếu giá trị là giờ địa phương. (Với DateTimeOffset thì chúng có chuyển đổi.)

Culture thay đổi đầu ra

Định dạng chuẩn, tên tháng và tên thứ, cùng các dấu phân cách / và : đều đến từ culture. Truyền một culture làm đối số thứ hai cho 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
    }
}

Đầu ra:

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

Dữ liệu culture không cố định. .NET trên Linux và macOS đọc nó từ thư viện ICU cài trên hệ thống, và từ .NET 5, .NET trên Windows 10 trở lên cũng vậy (.NET Framework dùng dữ liệu NLS riêng của Windows), nên một mẫu có thể thay đổi đôi chút giữa các phiên bản và nền tảng: chẳng hạn các bản ICU gần đây đặt một khoảng trắng hẹp không ngắt dòng thay vì khoảng trắng thường trước "PM" trong định dạng giờ ngắn của Mỹ, và một số bản cho ngày ngắn tiếng Tây Ban Nha không có số 0 ở đầu. Đó thêm một lý do để không bao giờ phân tích văn bản đã được định dạng để hiển thị.

Từ đó có hai quy tắc. Với văn bản dành cho người đọc, hãy định dạng theo culture của họ (trên máy chủ, đó là culture lấy từ request, không phải của máy chủ) và ưu tiên định dạng chuẩn, để người đọc Đức thấy 09.10.2026 còn người đọc Mỹ thấy 10/9/2026. Với văn bản dành cho chương trình, hãy dùng CultureInfo.InvariantCulture và một mẫu rõ ràng như yyyy-MM-dd hoặc o. Một ngày được ghi bằng culture hiện tại rồi được phân tích trên máy khác là nguồn kinh điển của lỗi đảo ngày và tháng.

ISO 8601 và round-trip với "o"

Định dạng round-trip "o" ghi đủ mọi tick cùng thông tin múi giờ, nên phân tích lại văn bản sẽ cho đúng DateTime ban đầu, kể cả Kind của nó:

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));
    }
}

Đầu ra:

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

Hậu tố Z đánh dấu UTC; DateTime có Kind là Unspecified không có hậu tố; giờ địa phương hoặc DateTimeOffset có độ lệch của nó (+02:00). Phân tích với DateTimeStyles.RoundtripKind để giữ lại Kind. Các bộ tuần tự hóa JSON, cơ sở dữ liệu và Date của JavaScript đều đọc được định dạng này.

Định dạng TimeSpan

TimeSpan có bộ ký hiệu tùy chỉnh riêng, nhỏ hơn: d (ngày), hh, mm, ss và fff. Khác với DateTime, mọi ký tự nguyên văn, kể cả : và ., phải được escape bằng dấu gạch chéo ngược hoặc đặt trong dấu nháy:

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
    }
}

Đầu ra:

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

hh trong định dạng TimeSpan là thành phần giờ (từ 0 đến 23), nên một khoảng thời gian 27 giờ được in ra là 03. Với tổng lớn hơn một ngày, hãy tính từ TotalHours như ở dòng cuối. elapsed.ToString("hh:mm") không có dấu gạch chéo ngược sẽ ném ra FormatException.

Lỗi thường gặp

• mm cho tháng. "yyyy-mm-dd" in số phút ở giữa: 2026-30-09. Tháng là MM.
• hh mà không có tt. "hh:mm" là đồng hồ 12 giờ không có AM hay PM, nên 06:30 không rõ là sáng hay tối. Dùng HH cho giờ dạng 24 giờ.
• YYYY và DD. Không phải ký hiệu định dạng trong .NET; chúng được in nguyên văn. Dùng yyyy và dd.
• / trong mẫu cho dữ liệu. Đó là dấu phân cách ngày của culture. Đặt nó trong dấu nháy hoặc dùng invariant culture.
• ToString() mặc định trong log hoặc tệp. Định dạng phụ thuộc vào máy. Hãy truyền định dạng và culture.
• Giờ địa phương bị gắn nhãn UTC. "u", "r" và 'Z' viết tay không chuyển đổi; hãy chuyển đổi trước.
• Phân tích bằng mẫu khác với mẫu đã dùng để ghi. Giữ chuỗi định dạng cho dữ liệu trong một hằng số và dùng nó cho cả ToString và ParseExact.