تنسيق 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 النص نفسه في كل ثقافة، وهذا يجعلها آمنة للسجلات وأسماء الملفات وتبادل البيانات. لاحظ أن u وr على DateTime لا تحوّلان القيمة إلى 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 ملتبسة. استخدم HH لوقت بنظام 24 ساعة.
• YYYY وDD. ليسا محدّدين في .NET؛ يُطبعان حرفيًا. استخدم yyyy وdd.
• / في نمط للبيانات. هو فاصل التاريخ في الثقافة. ضعه بين علامتي اقتباس أو استخدم الثقافة الثابتة.
• ToString() الافتراضية في السجلات أو الملفات. يعتمد التنسيق على الجهاز. مرّر تنسيقًا وثقافة.
• وقت محلي موصوف بأنه UTC. لا تحوّل "u" و"r" و'Z' المكتوبة يدويًا؛ حوّل أولًا.
• القراءة بنمط غير الذي كتبت به. احفظ نصوص تنسيق البيانات في ثابت واحد واستخدمه مع ToString وParseExact كليهما.