DATETIMEADD - Cosmos DB'de sorgu dili (Azure ve Doku'da)

İşlev, DATETIMEADD belirtilen sayı değerini sağlanan tarih ve saat dizesine eklemenin sonucu olan bir tarih ve saat dizesi değeri döndürür.

Sözdizimi

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

Arguments

	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ği 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.

Dönüş türleri

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

Örnekler

Bu bölüm, bu sorgu dili yapısının nasıl kullanılacağına örnekler içerir.

Tarih parçalarını ekleme ve çıkarma

Bu örnekte işlev, DATETIMEADD bir tarihe yıl, ay, gün ve saat eklemek ve çıkarmak için kullanılı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

• ISO 8601 tarih biçimi, bu işlevle kullanılacak geçerli tarih ve saat bölümlerini belirtir: | | Biçim | | --- | --- | | Yıl | year, yyyy, yy | | Ay | month, mm, m | | Gün | day, dd, d | | Saat | hour, hh | | Minute | minute, mi, n | | İkinci | second, ss, s | | Milisaniye | millisecond, ms | | Mikrosaniye | microsecond, mcs | | Nanosaniye | nanosecond,ns |
• Bu işlev şu nedenlerle döndürülüyor 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.