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 | year, yyyy, yy | | الشهر | month، mm، | m | اليوم | day، dd، | d | ساعة | hour، hh | | دقيقة | minute، mi، n | | ثانيا | second، ss، | s | مللي ثانية | millisecond، ms | | ميكرو ثانية | microsecond، mcs | | Nanosecond | nanosecond، ns |

المحتوى ذو الصلة

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