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