DateTimeAdd (استعلام NoSQL)

ينطبق على: NoSQL

إرجاع قيمة سلسلة التاريخ والوقت التي هي نتيجة لإضافة قيمة رقم محددة إلى سلسلة التاريخ والوقت المتوفرة.

بناء الجملة

DateTimeAdd(<date_time_part>, <numeric_expr> ,<date_time>)

الوسيطات

	الوصف
date_time_part	سلسلة تمثل جزءا من مواصفات تنسيق التاريخ ISO 8601. يستخدم هذا الجزء للإشارة إلى جانب التاريخ المراد تعديله بواسطة التعبير الرقمي ذي الصلة.
numeric_expr	تعبير رقمي ينتج عنه عدد صحيح موقع.
date_time	سلسلة تاريخ ووقت عالمي منسق (UTC) بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

ملاحظة

لمزيد من المعلومات حول تنسيق ISO 8601، راجع ISO 8601.

أنواع الإرجاع

إرجاع سلسلة تاريخ ووقت UTC بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

أمثلة

يضيف المثال التالي قيما مختلفة (سنة واحدة، شهر واحد، يوم واحد، ساعة واحدة) إلى تاريخ 3 يوليو 2020 عند منتصف الليل (00:00 بالتوقيت العالمي المتفق عليه). يطرح المثال أيضا قيما مختلفة (سنتان، شهران، يومين، ساعتين) من نفس التاريخ. وأخيرا، يستخدم هذا المثال تعبيرا لتعديل الثوان من نفس التاريخ.

SELECT VALUE {
    addOneYear: DateTimeAdd("yyyy", 1, "2020-07-03T00:00:00.0000000"),
    addOneMonth: DateTimeAdd("mm", 1, "2020-07-03T00:00:00.0000000"),
    addOneDay: DateTimeAdd("dd", 1, "2020-07-03T00:00:00.0000000"),
    addOneHour: DateTimeAdd("hh", 1, "2020-07-03T00:00:00.0000000"),
    subtractOneYear: DateTimeAdd("yyyy", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneMonth: DateTimeAdd("mm", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneDay: DateTimeAdd("dd", -1, "2020-07-03T00:00:00.0000000"),
    subtractOneHour: DateTimeAdd("hh", -1, "2020-07-03T00:00:00.0000000"),
    modifySecondsExpression: DateTimeAdd("ss", 5 * -5, "2020-07-03T00:00:00.0000000")
}

[
  {
    "addOneYear": "2021-07-03T00:00:00.0000000Z",
    "addOneMonth": "2020-08-03T00:00:00.0000000Z",
    "addOneDay": "2020-07-04T00:00:00.0000000Z",
    "addOneHour": "2020-07-03T01:00:00.0000000Z",
    "subtractOneYear": "2019-07-03T00:00:00.0000000Z",
    "subtractOneMonth": "2020-06-03T00:00:00.0000000Z",
    "subtractOneDay": "2020-07-02T00:00:00.0000000Z",
    "subtractOneHour": "2020-07-02T23:00:00.0000000Z",
    "modifySecondsExpression": "2020-07-02T23:59:35.0000000Z"
  }
]

الملاحظات

• ترجع undefined هذه الدالة لهذه الأسباب:
  • جزء التاريخ والوقت المحدد غير صحيح.
  • التعبير الرقمي ليس عددا صحيحا صحيحا.
  • التاريخ والوقت في الوسيطة ليسا سلسلة تاريخ ووقت ISO 8601 صالحة.
• يحدد تنسيق تاريخ ISO 8601 أجزاء تاريخ ووقت صالحة لاستخدامها مع هذه الدالة: | | تنسيق | | --- | --- | | السنة | year، yyyy، yy | | الشهر | month، mm، m | | اليوم | day، dd، d | | ساعة | hour، hh | | دقيقة | minute، ، nmi| | ثانيا | second، ، sss| | مللي ثانية | millisecond، ms | | ميكرو ثانية | microsecond، mcs | | Nanosecond | nanosecond،ns |

محتوى مرتبط

• وظائف النظام
• DateTimeBin