وظيفة DATETIMEVALUE ER
تُرجع الدالة DATETIMEVALUE قيمة DateTime تم تحويلها من قيمة نصية مُعينة في التنسيق المحدد وفي ثقافة محددة بشكل اختياري إلى قيمة تاريخ/وقت. لمزيد من المعلومات حول التنسيقات المعتمدة، راجع قياسي و مخصص.
بناء الجملة 1
DATETIMEVALUE (text, format)
بناء الجملة 2
DATETIMEVALUE (text, format, culture)
الوسائط
text: سلسلة
النص الذي يمثل القيمة المراد تنسيقها.
format: سلسلة
تنسيق النص المُعين. لمزيد من المعلومات حول التنسيقات المعتمدة، راجع قياسي و مخصص.
culture: سلسلة
الثقافة المستخدمة لتنسيق النص المُحدد. للحصول علي معلومات حول الثقافات المعتمدة، راجع الثقافة.
إرجاع القيم
التاريخ/الوقت
قيمة التاريخ/الوقت الناتجة.
ملاحظات الاستخدام
عندما لا يتم تعريف الثقافة كوسيطة للوظيفة التي تم استدعائها، يتم تعريف قيمة culture عن طريق سياق الاستدعاء. على سبيل المثال، إذا تم استدعاء الوظيفة DATETIMEVALUE باستخدام بناء الجملة 1 في تنسيق التقارير الإلكترونية (ER) لعنصر FILE تم تكوينه لاستخدام الثقافة الألمانية، فسوف يتم التحويل باستخدام الثقافة الألمانية. قيمة culture الافتراضية هي EN-US.
مثال1
يُرجع التعبير DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss")2:55:00 ص في 21 ديسمبر 2016 ، استنادًا إلى التنسيق المخصص وثقافة EN-US للتطبيق الافتراضي.
مثال2
يُرجع التعبير DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT")2:55:00 ص في 21 ديسمبر 2016 ، استنادًا إلى التنسيق المخصص والثقافة.
ومع ذلك، ستطرح DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") استثناءً لإعلام المستخدم بأنه لم يتم التعرف على السلسلة المحددة كقيمة تاريخ/وقت صالحة للثقافة المُحددة.