نوع بيانات Date في (Visual Basic)
يحتفظ IEEE ٦٤ بت (8 بايت) بالقيم التي تمثل تواريخ يتراوح بين 1 يناير من السنة 0001 إلى 31 ديسمبر من السنة 9999، والأوقات من 12: 00: 00 ص (منتصف الليل) خلال 11:59:59.9999999 م. تمثل كل زيادة 100 نانو من الثانية للوقت المنقضي منذ البداية 1 يناير من السنة 1 في تقويم الميلادي. تمثل القيمة القصوى 100 نانو من الثانية قبل بداية 1 يناير من السنة 10000.
ملاحظات
استخدام نوع بيانات Date ليحتوي على قيم التاريخ أو قيم الوقت قيم التاريخ والوقت.
القيم الافتراضية ل Date هي 0:00:00 (منتصف الليل) في 1 يناير, 0001.
يمكنك الحصول على التاريخ والوقت الحالي من من فئة DateAndTime.
متطلبات التنسيق
يجب عليك إحاطة القيمة الحرفية Date داخل علامات رقم (# #). يجب تحديد قيمة التاريخ في التنسيق M/d/yyyy على سبيل المثال #5/31/1993#. هذا المتطلب مستقل عن الإعدادات المحلية الخاصة بك وإعدادات تنسيق التاريخ والوقت للكمبيوتر الخاص بك.
سبب هذا التقييد هو أن معنى التعليمات البرمجية الخاصة بك لايجب أن تتغير أبداً بناءً على الإعدادات المحلية التي يعمل التطبيق الخاص بك عليها. افترض أنك تقوم بكتابة تعليمات برمجية مضمّنة لقيمة حرفية Date ل #3/4/1998# و ترغب أن يعني 4 مارس 1998. في الإعدادات محلية التي تستخدم mm/dd/yyyy، يتم التحويل البرمجي ل 3/4/1998 كما كنت تقصد. ولكن افترض أنك تنشر تطبيقك في العديد من البلدان. في الإعدادات محلية التي تستخدم dd/mm/yyyy ، القيمة الحرفية للتعليمات البرمجية المضمنة يتم ترجمتها إلى 3 أبريل 1998. في الإعدادات محلية التي تستخدم yyyy/mm/dd، القيمة الحرفية ستكون غير صحيحة (1998 أبريل ، 0003) وتسبب خطأ في المحول برمجي.
الحلول
لتحويل قيمة حرفية Date إلى لتنسيق الإعدادات المحلية الخاصة بك، أو إلى تنسيق مخصص، قم بتوفير القيمة الحرفية إلى دالة Format، محددأً إما تنسيق تاريخ محددة مسبقاً أو يتم محدده من قبل المستخدم. يوضح المثال التالي هذا.
MsgBox("The formatted date is " & Format(#5/31/1993#, "dddd, d MMM yyyy"))
بشكل بديل، يمكنك استخدام أحد المنشئات المحملة بشكل زائد من البنية DateTime لتجميع قيمة التاريخ والوقت. يقوم المثال التالي بإنشاء قيمة لتمثل 31 مايو 1993 في 12: 14 في العصر.
Dim dateInMay As New System.DateTime(1993, 5, 31, 12, 14, 0)
تنسيق ساعة
يمكنك تحديد قيمة الوقت بتنسيق 12 ساعة أو 24 ساعة, على سبيل المثال #1:15:30 PM# أو #13:15:30#. ومع ذلك، إذا لم تقم بتعيين الدقائق أو الثواني يجب عليك تحديد ص أو م.
قيم افتراضية للوقت والتاريخ
في حالة عدم تضمين تاريخ في قيمة حرفية التاريخ/الوقت، يقوم Visual Basic بتعيين جزء التاريخ للقيمة إلى يناير 1، 0001. إذا لم تقم بتضمين الوقت في القيمة الحرفية التاريخ/الوقت، يقوم Visual Basic بتعيين جزء الوقت للقيمة إلى بداية اليوم، منتصف الليل (0: 00: 00).
تحويلات النوع
إذا قمت بتحويل قيمة Date إلى نوع String ، يعرض Visual Basic التاريخ وفقاً لتنسيق التاريخ القصير المحدد بواسطة الإعدادات المحلية لوقت التشغيل, و يعرض الوقت وفقاً لتنسيق الوقت ( إما 12 ساعة أو 24 ساعة) المحدد بواسطة الإعدادات المحلية لوقت التشغيل.
التلميحات البرمجية
اعتبارات التوافق. إذا كنت تواجه مكونات لم يتم كتابتها ل NET Framework. ، على سبيل المثال التنفيذ التلقائي أو كائنات COM، ضع في الاعتبار أن أنواع التاريخ/الوقت في بيئات أخرى غير متوافقة مع نوع Date في Visual Basic. إذا تم تمرير وسيطة التاريخ/الوقت إلى مثل هذا مكون ، قم بتعريفه كما هو Double بدلاً من Date في تعليماتك البرمجية الجديدة في Visual Basic، واستخدم أساليب التحويل DateTime.FromOADate و DateTime.ToOADate.
نوع الأحرف. Date لا يحتوي على حرف نوع القيمة الحرفية أو حرف النوع المعرّف. ومع ذلك، يعامل المحول البرمجي القيم الحرفية المحاطة داخل علامة رقم (# #) كـ Date.
نوع إطار العمل. النوع المطابق في .NET Framework هو بنية System.DateTime.
مثال
متغير أو ثابت لنوع بيانات Date يقيد كلا التاريخ والوقت. فيما يلي مثال يوضّح ذلك.
Dim someDateAndTime As Date = #8/13/2002 12:14 PM#
راجع أيضًا:
المرجع
خلاصة نوع بيانات (Visual Basic)