وظيفة DATETIMEFORMAT ER

تُرجع الدالة DATETIMEFORMAT قيمة سلسلة تمثل قيمة تاريخ/وقت معين كنص في التنسيق المحدد وفي ثقافة محددة بشكل اختياري. لمزيد من المعلومات حول التنسيقات المعتمدة، راجع قياسي و مخصص.

بناء الجملة 1

DATETIMEFORMAT (datetime, format)

بناء الجملة 2

DATETIMEFORMAT (datetime, format, culture)

الوسائط

datetime: التاريخ والوقت

قيمة التاريخ/الوقت التي تمثل التاريخ والوقت المراد تنسيقه.

format: سلسلة

تنسيق سلسلة الإخراج. لمزيد من المعلومات حول التنسيقات المعتمدة، راجع قياسي و مخصص.

إشعار

تكون سلسله التنسيق حساسة لحاله الأحرف عند استخدام اما تنسيق قياسي أو تنسيق مخصص. علي سبيل المثال، يقوم محدد التنسيق القياسي "d" بإرجاع التاريخ باستخدام نمط التاريخ القصير، بينما يقوم محدد التنسيق القياسي "d" بإرجاع التاريخ باستخدام نمط التاريخ الطويل. بالاضافه إلى ذلك ، يقوم محدد التنسيق المخصص "m" بإرجاع الشهر من 1 إلى 12، بينما يقوم محدد التنسيق المخصص "m" بإرجاع الدقيقة من 0 إلى 59.

culture: سلسلة

الثقافة التي سيتم استخدامها للتنسيق. للحصول علي معلومات حول الثقافات المعتمدة، راجع الثقافة.

إرجاع القيم

سلسلة

قيمة السلسلة الناتجة.

ملاحظات الاستخدام

إذا لم يتم تعريف الثقافة كوسيطة للوظيفة التي تم استدعائها، يتم تعريف قيمة culture عن طريق سياق الاستدعاء. على سبيل المثال، إذا تم استدعاء الوظيفة DATETIMEFORMAT باستخدام بناء الجملة 1 في تنسيق التقارير الإلكترونية (ER) لعنصر FILE تم تكوينه لاستخدام الثقافة الألمانية، فسوف يتم التحويل باستخدام الثقافة الألمانية. قيمة culture الافتراضية هي EN-US.

عندما تقوم الوظيفة DATETIMEFORMAT بتحويل قيمة تاريخ/وقت مُحدد، فإنها تعتبر إعداد المنطقة الزمنية لمستخدم التطبيق الذي يقوم بتشغيل تنسيق ER الذي تمت استدعاء الوظيفة في سياقه.

مثال1

يُرجع التعبير DATETIMEFORMAT (NOW(), "dd-MM-yyyy") قيمة تاريخ/وقت خادم التطبيق الحالي، 24 ديسمبر 2015، كـ "24-12-2015"، بناءً على التنسيق المخصص المُحدد.

مثال2

تُرجع وظيفة DATETIMEFORMAT (SESSIONNOW(), "d", "DE") قيمة تاريخ/وقت جلسة التطبيق الحالية، 24 ديسمبر 2015، كـ "24.12.2015"، بناءً على الثقافة الألمانية المُحددة والتنسيق المُحدد.

المثال الثالث

تُرجع DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") قيمة السلسلة 2019-11-12T08:00:00.0000000-08:00 عندما يتم استدعاء الدالة أثناء عملية تم البدء فيها بواسطة مستخدم تطبيق لديه قيمة منطقة زمنية ‏‏‫(GMT-08:00) توقيت الباسيفيكي (الولايات المتحدة وكند)‬‬ في قسم تفضيلات البلد/المنطقة واللغة‬.

الموارد الإضافية

دلات التاريخ والوقت