Share via

DateTimeAdd (NoSQL sorgusu)

  • Makale

UYGULANANLAR: NOSQL

Sağlanan tarih ve saat dizesine belirtilen bir sayı değeri eklemenin sonucu olan bir tarih ve saat dizesi değeri döndürür.

Söz dizimi

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

Bağımsız değişkenler

Description
date_time_part ISO 8601 tarih biçimi belirtiminin bir bölümünü temsil eden dize. Bu bölüm, ilgili sayısal ifade tarafından tarihin hangi yönünün değiştirileceğini belirtmek için kullanılır.
numeric_expr İmzalı bir tamsayıyla sonuçlanan sayısal ifade.
date_time ISO 8601 biçiminde YYYY-MM-DDThh:mm:ss.fffffffZeşgüdümlü Evrensel Saat (UTC) tarih ve saat dizesi.

Not

ISO 8601 biçimi hakkında daha fazla bilgi için bkz. ISO 8601.

Dönüş türleri

ISO 8601 biçiminde YYYY-MM-DDThh:mm:ss.fffffffZbir UTC tarih ve saat dizesi döndürür.

Örnekler

Aşağıdaki örnek, 3 Temmuz 2020 gece yarısı (00:00 UTC) tarihine çeşitli değerler (bir yıl, bir ay, bir gün, bir saat) ekler. Örnek ayrıca çeşitli değerleri (iki yıl, iki ay, iki gün, iki saat) aynı tarihten çıkarır. Son olarak, bu örnek aynı tarihin saniyelerini değiştirmek için bir ifade kullanır.

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"
  }
]

Açıklamalar

  • Bu işlev şu nedenlerle döndürür undefined :
    • Belirtilen tarih ve saat bölümü geçersiz.
    • Sayısal ifade geçerli bir tamsayı değil.
    • Bağımsız değişkendeki tarih ve saat geçerli bir ISO 8601 tarih ve saat dizesi değil.
  • ISO 8601 tarih biçimi, bu işlevle kullanılacak geçerli tarih ve saat bölümlerini belirtir: | | Biçim | | --- | --- | | Year | year, yyyy, yy | | Month | month, mm, m | | Gün | day, dd, d | | Saat | hour, hh | | Minute | minute, mi, n | | second | second, ss, s | | Milisaniye | millisecond, ms | | Mikrosaniye | microsecond, mcs | | Nanosaniye | nanosecond, ns |

İlgili içerik