Date_Bucket (Transact-SQL)

Bu işlev, her bir tarih saat demetinin başına, parametresi tarafından tanımlanan zaman damgasından origin veya origin parametresi belirtilmemişse varsayılan Origin değeri ile eşleşen tarih saat aralığını döndürür 1900-01-01 00:00:00.000 .

tüm transact-SQL tarih ve saat veri türleri ve işlevlerine genel bir bakış için bkz. tarih ve saat veri türleri ve işlevleri (transact-SQL) .

Transact-SQL sözdizimi kuralları

Söz dizimi

DATE_BUCKET (datePart, number, date, origin)

Bağımsız değişkenler

Işlevindeki

' Number ' parametresiyle kullanılan tarihin bölümü. Örn. Yıl, ay, dakika, saniye vb.

sayısından

Değer, datePart bağımsız değişkeniyle birleştirilmiş olan demet genişliğine karar veren tamsayı numarası. Bu, kaynak zamandan itibaren veri bölümü demetlerinin genişliğini temsil eder. This argument cannot be a negative integer value.

date

Aşağıdaki değerlerden birine çözümleyebilecek bir ifade:

• date
• datetime
• datetime2
• türünde
• girişin
• ışınızda

Tarih için, DATE_BUCKET yukarıda belirtilen veri türlerine çözümlendiklerinde bir sütun ifadesi, ifade veya Kullanıcı tanımlı değişken kabul eder.

Tıdır

Aşağıdaki değerlerden birine çözümleyebilecek isteğe bağlı bir ifade:

• date
• datetime
• datetime2
• türünde
• girişin
• ışınızda

İçin veri türü, Origin parametrenin veri türüyle eşleşmelidir Date .

DATE_BUCKET işlev için bir kaynak değer belirtilmemişse, Ocak 12:00 ' de, varsayılan bir başlangıç tarihi değeri olan 1900-01-01 00:00:00.000 örn. Pazartesi, 1 1900 Ocak.

Dönüş Türü

Bu yöntemin dönüş değeri veri türü dinamiktir. Dönüş türü, için sağlanan bağımsız değişkene bağlıdır date . İçin geçerli bir giriş veri türü sağlanırsa date , DATE_BUCKET aynı veri türünü döndürür. DATE_BUCKET parametresi için bir dize sabit değeri belirtilmişse bir hata oluşturur date .

Dönüş Değerleri

Çıktıyı anlama DATE_BUCKET

Date_Bucket datePart ve Number parametresine karşılık gelen en geç tarih veya saat değerini döndürür. Örneğin, aşağıdaki ifadelerde çıkış Date_Bucket değeri döndürülür, 2020-04-13 00:00:00.0000000 çünkü çıkış varsayılan kaynak zamanından itibaren bir hafta demetlerine göre hesaplanır 1900-01-01 00:00:00.000 . Değer, 2020-04-13 00:00:00.0000000 kaynak değerinden 6276 haftadan oluşur 1900-01-01 00:00:00.000 .

declare @date datetime2 = '2020-04-15 21:22:11'
Select DATE_BUCKET(wk, 1, @date)

Aşağıdaki tüm ifadeler için aynı çıkış değeri 2020-04-13 00:00:00.0000000 döndürülecek. Bunun nedeni, 2020-04-13 00:00:00.0000000 kaynak tarihinden itibaren 6276 hafta ve 6276, 2, 3, 4 ve 6 ' a bölünebilmelidir.

declare @date datetime2 = '2020-04-15 21:22:11'
Select DATE_BUCKET(wk, 2, @date)
Select DATE_BUCKET(wk, 3, @date)
Select DATE_BUCKET(wk, 4, @date)
Select DATE_BUCKET(wk, 6, @date)

Aşağıdaki ifade için çıkış, 2020-04-06 00:00:00.0000000 varsayılan kaynak saatten 6275 hafta olan 1900-01-01 00:00:00.000 .

declare @date datetime2 = '2020-04-15 21:22:11'
Select DATE_BUCKET(wk, 5, @date)

Aşağıdaki ifade için çıkış, 2020-06-09 00:00:00.0000000 belirtilen kaynak saatten 75 hafta olan 2019-01-01 00:00:00 .

declare @date datetime2 = '2020-06-15 21:22:11'
declare @origin datetime2 = '2019-01-01 00:00:00'
Select DATE_BUCKET(wk, 5, @date, @origin)

datepart bağımsız değişkeni

DayOfYear, Day ve HAFTANINGÜNÜ aynı değeri döndürür. Her datepart ve kısaltmalar aynı değeri döndürür.

sayı bağımsız değişkeni

Sayı bağımsız değişkeni pozitif int değerlerinin aralığını aşamaz. Aşağıdaki deyimlerde, sayı bağımsız değişkeni int ile 1 aralığını aşıyor. Aşağıdaki ifade şu hata iletisini döndürür: "Msg 8115, Level 16, State 2, Line 2. Arithmetic overflow error converting expression to data type int."

declare @date datetime2 = '2020-04-30 00:00:00'
Select DATE_BUCKET(dd, 2147483648, @date)

İşleve negatif bir sayı değeri geçirilirse Date_Bucket , aşağıdaki hata döndürülür.

Msg 9834, Level 16, State 1, Line 1
Invalid bucket width value passed to date_bucket function. Only positive values are allowed.

Tarih bağımsız değişkeni

DATE_BUCKET bağımsız değişkenin veri türüne karşılık gelen temel değeri döndürün date . Aşağıdaki örnekte, datetime2 veri türüne sahip bir çıkış değeri döndürülür.

Select DATE_BUCKET(dd, 10, SYSUTCDATETIME())

kaynak bağımsız değişkeni

originİçindeki ve bağımsız değişkenlerin veri türü date aynı olmalıdır. Farklı veri türleri kullanılıyorsa bir hata oluşturulur.

Açıklamalar

DATE_BUCKETAşağıdaki yan tümcelerde kullanın:

• GROUP BY
• HAVING
• SİPARİŞ VEREN
• SEÇIN <list>
• WHERE

Örnekler

A. Kaynak zamanından 1 demet genişliğine sahip Date_Bucket hesaplanıyor

Bu deyimlerden her biri, kaynak zamandan 1 demet genişliğiyle date_bucket artırır:

declare @date datetime2 = '2020-04-30 21:21:21'
Select 'Week',  DATE_BUCKET(wk, 1, @date)
Union All
Select 'Day',  DATE_BUCKET(dd, 1, @date)
Union All
Select 'Hour',  DATE_BUCKET(hh, 1, @date)
Union All
Select 'Minutes',  DATE_BUCKET(mi, 1, @date)
Union All
Select 'Seconds',  DATE_BUCKET(ss, 1, @date)

Sonuç kümesini burada bulabilirsiniz.

Week    2020-04-27 00:00:00.0000000
Day     2020-04-30 00:00:00.0000000
Hour    2020-04-30 21:00:00.0000000
Minutes 2020-04-30 21:21:00.0000000
Seconds 2020-04-30 21:21:21.0000000

B. İfadeleri sayı ve Tarih parametreleri için bağımsız değişken olarak kullanma

Bu örnekler, sayı ve Tarih parametreleri için bağımsız değişken olarak farklı tür ifadeler kullanır. Bu örnekler ' AdventureWorksDW2017 ' veritabanı kullanılarak oluşturulmuştur.

Kullanıcı tanımlı değişkenleri sayı ve tarih olarak belirtme

Bu örnek, sayı ve tarih için bağımsız değişken olarak kullanıcı tanımlı değişkenleri belirtir:

DECLARE @days int = 365,
        @datetime datetime2 = '2000-01-01 01:01:01.1110000'; /* 2000 was a leap year */;
SELECT Date_Bucket(day, @days, @datetime);

Sonuç kümesini burada bulabilirsiniz.

---------------------------
1999-12-08 00:00:00.0000000

(1 row affected)

Bir sütunu tarih olarak belirtme

Aşağıdaki örnekte, haftalık tarih demetleri üzerinden gruplanmıştır OrderQuantity ve UnitPrice toplamının toplamını hesaplamış oluruz.

SELECT
    Date_Bucket(week, 1 ,cast(Shipdate as datetime2)) AS ShippedDateBucket
    ,Sum(OrderQuantity)  As SumOrderQuantity
    ,Sum(UnitPrice) As SumUnitPrice
FROM dbo.FactInternetSales FIS
where Shipdate between '2011-01-03 00:00:00.000' and '2011-02-28 00:00:00.000'
Group by Date_Bucket(week, 1 ,cast(Shipdate as datetime2))
order by 1

Sonuç kümesini burada bulabilirsiniz.

ShippedDateBucket           SumOrderQuantity SumUnitPrice
--------------------------- ---------------- ---------------------
2011-01-03 00:00:00.0000000 21               65589.7546
2011-01-10 00:00:00.0000000 27               89938.5464
2011-01-17 00:00:00.0000000 31               104404.9064
2011-01-24 00:00:00.0000000 36               118525.6846
2011-01-31 00:00:00.0000000 39               123555.431
2011-02-07 00:00:00.0000000 35               109342.351
2011-02-14 00:00:00.0000000 32               107804.8964
2011-02-21 00:00:00.0000000 37               119456.3428
2011-02-28 00:00:00.0000000 9                28968.6982

Skaler sistem işlevini tarih olarak belirtme

Bu örnek, tarih SYSDATETIME için belirtir. Döndürülen tam değer, deyim yürütmenin gün ve saatlerine bağlıdır:

SELECT Date_Bucket(wk, 10, SYSDATETIME());

Sonuç kümesini burada bulabilirsiniz.

---------------------------
2020-03-02 00:00:00.0000000

(1 row affected)

Skaler alt dizileri ve skaler işlevleri sayı ve tarih olarak belirtme

Bu örnekte sayı ve tarih için bağımsız değişken MAX(OrderDate) olarak skaler alt diziler ( ) edilmektedir. (SELECT top 1 CustomerKey FROM dbo.DimCustomer where GeographyKey > 100) , bir değer listesinden sayı bağımsız değişkeni seçmeyi göstermek için sayı parametresi için yapay bağımsız değişken olarak görev gösterir.

SELECT DATE_BUCKET(week,(SELECT top 1 CustomerKey FROM dbo.DimCustomer where GeographyKey > 100),
    (SELECT MAX(OrderDate) FROM dbo.FactInternetSales));

Sayısal ifadeler ve skaler sistem işlevlerini sayı ve tarih olarak belirtme

Bu örnekte sayı ve tarih bağımsız değişkenleri olarak sayısal bir ifade ((10/2)) ve skaler sistem işlevleri (SYSDATETIME) kullanılır.

SELECT Date_Bucket(week,(10/2), SYSDATETIME());

Toplama penceresi işlevini sayı olarak belirtme

Bu örnekte sayı bağımsız değişkeni olarak bir toplama penceresi işlevi mektedir.

Select
    DISTINCT DATE_BUCKET(day, 30, Cast([shipdate] as datetime2)) as DateBucket,
    First_Value([SalesOrderNumber]) OVER (Order by DATE_BUCKET(day, 30, Cast([shipdate] as datetime2))) as First_Value_In_Bucket,
    Last_Value([SalesOrderNumber]) OVER (Order by DATE_BUCKET(day, 30, Cast([shipdate] as datetime2))) as Last_Value_In_Bucket
    from [dbo].[FactInternetSales]
Where ShipDate between '2011-01-03 00:00:00.000' and '2011-02-28 00:00:00.000'
order by DateBucket
GO

C. Varsayılan olmayan bir çıkış noktası değeri kullanma

Bu örnekte, tarih demetlerini oluşturmak için varsayılan olmayan bir çıkış noktası değeri kullanılır.

declare @date datetime2 = '2020-06-15 21:22:11'
declare @origin datetime2 = '2019-01-01 00:00:00'
Select DATE_BUCKET(hh, 2, @date, @origin)

Ayrıca bkz.

Transact-(CAST ve CONVERT SQL)