الدالة TimeValue

ينطبق على
Access لـ Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

إرجاع متغير ‏(تاريخ) يحتوي على الوقت.

بناء الجملة

TimeValue(time)

تكون وسيطة الوقتالمطلوب عادة تعبير سلسلة يمثل وقتا من 0:00:00 (12:00:00 ص) إلى 23:59:59 (11:59:59 م)، ضمنا. ومع ذلك، يمكن أن يكون الوقت أي تعبير يمثل وقتا في ذلك النطاق. إذا كان الوقت يحتوي على Null، فسيتم إرجاع القيمة Null .

ملاحظات

يمكنك إدخال أوقات صالحة باستخدام نظام وقت يعرض 12 ساعة أو 24 ساعة. على سبيل المثال، "2:24PM" وكلاهما "14:24" وسيطتان وقتتان صالحتان.

إذا كانت وسيطة الوقت تحتوي على معلومات التاريخ، فلن ترجعها TimeValue . ومع ذلك، إذا تضمن الوقت معلومات تاريخ غير صالحة، يحدث خطأ.

أمثلة عن الاستعلام

التعبير النتائج
SELECT TimeValue([DateTime]) AS Expr1 FROM ProductSales; ترجع قيم الوقت للحقل "DateTime" بدون معلومات التاريخ ويتم عرضها في العمود Expr1.
SELECT TimeValue([DateTime]) AS JustTime FROM ProductSales; ترجع قيم الوقت للحقل "DateTime" بدون معلومات التاريخ ويتم عرضها في العمود JustTime.

مثال VBA

ملاحظة

توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية ل Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد "مرجع المطور" في القائمة المنسدلة بجوار "بحث" وأدخل مصطلح أو أكثر في مربع البحث.

يستخدم هذا المثال الدالة TimeValue لتحويل سلسلة إلى وقت. يمكنك أيضا استخدام أحرف التواريخ لتعيين وقت مباشرة إلى متغير أو متغير تاريخ ، على سبيل المثال، MyTime = #4:35:17 PM#.

Dim MyTime
MyTime = TimeValue("4:35:17 PM")    ' Return a time.

اختيار دالة التاريخ المناسبة