Verilen bir tarihin belirtilen kısmını içeren bir Variant (Tamsayı) döndürür.
| Uyarı Bu işlevin kullanımıyla ilgili bir sorun var. Bazı takvim yıllarında son Pazartesi günü, 1. hafta olması gerekirken 53. hafta olarak döndürülebilir. Daha fazla bilgi ve geçici bir çözüm için bkz: Biçim veya Tarih Bölümü işlevleri Yılın son Pazartesi günü için yanlış hafta numarası döndürebilir. |
|---|
Söz dizimi
DatePart(aralık, tarih [, haftanın ilk günü] [, yılınilkhaftası] )
DatePart işlevinin söz diziminde aşağıdaki bağımsız değişkenler bulunur:
| Bağımsız değişken | Açıklama |
|---|---|
| aralık | Gerekli. Dize ifadesi, vermek istediğiniz zaman aralığıdır. |
| Tarih | Gerekli. Değerlendirmek istediğiniz değişken (Tarih) değeri. |
| haftanınilkgünü | İsteğe bağlı. Haftanın ilk gününü belirten sabit. Belirtilmezse, Pazar varsayılır. |
| yılınilkhaftası | İsteğe bağlı. Yılın ilk haftasını belirten sabit. Belirtilmezse, 1 Ocak'ın bulunduğu hafta ilk hafta olarak varsayılır. |
Ayarlar
Aralık bağımsız değişkeni aşağıdaki ayarlara sahiptir:
| Ayar | Açıklama |
|---|---|
| yyyy | Yıl |
| ç | Çeyrek |
| a | Ay |
| y | Yılın günü |
| d | Gün |
| h | Weekday |
| hh | Hafta |
| s | Saat |
| d | Dakika |
| sn | Saniye |
Haftanın ilk günü bağımsız değişkeninde aşağıdaki ayarlar bulunur:
| Sabit | Değer | Açıklama |
|---|---|---|
| vbUseSystem | 0 | NLS API ayarını kullanın. |
| vbSunday | 1 | Pazar (varsayılan) |
| vbMonday | 2 | Pazartesi |
| vbTuesday | 3 | Salı |
| vbWednesday | 4 | Çarşamba |
| vbThursday | 5 | Perşembe |
| vbFriday | 6 | Cuma |
| vbCumartesi | 7 | Cumartesi |
Yılınilkhaftası bağımsız değişkeninde aşağıdaki ayarlar bulunur:
| Sabit | Değer | Açıklama |
|---|---|---|
| vbUseSystem | 0 | NLS API ayarını kullanın. |
| vbFirstJan1 | 1 | 1 Ocak'ın bulunduğu hafta ile başlayın (varsayılan). |
| vbFirstFourDays | 2 | Yeni yılda en az dört gün olan ilk haftadan başlayın. |
| vbFirstFullWeek | 3 | Yılın ilk tam haftasıyla başlayın. |
Açıklamalar
Bir tarihi hesaplamak ve belirli bir zaman aralığı döndürmek için DatePart işlevini kullanabilirsiniz. Örneğin, haftanın gününü veya geçerli saati hesaplamak için DatePart'ı kullanabilirsiniz.
Haftanın ilk günü bağımsız değişkeni, "w" ve "ww" aralık simgelerinin kullanıldığı hesaplamaları etkiler.
Tarih bir tarih değişmez ise, belirtilen yıl o tarihin kalıcı bir parçası olur. Ancak, tarih çift tırnak içine alınmışsa (" "), ve yılı atlarsanız, tarih ifadesi her değerlendirildiğinde kodunuza geçerli yıl eklenir. Bu, farklı yıllarda kullanılabilecek kod yazmayı mümkün kılar.
Not
Tarih için, CalendarCalendar özelliği ayarı Gregoryen ise, sağlanan tarih Gregoryen olmalıdır. Takvim Hicri ise, belirtilen tarih Hicri olmalıdır.
Döndürülen tarih bölümü geçerli Arap takviminin zaman dilimi birimlerindedir. Örneğin, güncel takvim Hicri ise ve döndürülecek tarih kısmı yılsa, yıl değeri bir Hicri yıldır.
Sorgu örnekleri
| İfade | Sonuçlar |
|---|---|
| SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" alanının tarih değerlerinin "Year" değerini döndürür. |
| SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" alanındaki tarih değerlerinin "Çeyrek" değerini (takvim yılına göre) verir. |
| SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" alanının tarih değerlerinin "Yılın Günü"nü (1 - 365) döndürür. |
| SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" alanının tarih değerlerinin "Gün" değerini döndürür. |
| SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" alanındaki tarih değerlerinin "Haftanın Günü" değerini (1 ile 7 arasında; burada 1 Pazar değerini temsil eder) döndürür. |
| SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" alanının tarih değerlerinin "Hafta numarasını" (1 ile 52 arasında) verir. |
| SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | "DateTime" alanının tarih değerlerinin "Hour" değerini döndürür. |
| SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; | "DateTime" alanının tarih değerlerinin "Dakika" değerini döndürür. |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | "DateTime" alanının tarih değerlerinin "saniye" değerini döndürür. |
VBA örneği
Not
Aşağıdaki örneklerde, bu işlevin Visual Basic for Applications (VBA) modülünde kullanımı gösterilir. VBA ile çalışma hakkında daha fazla bilgi için, rama'nın yanındaki açılan listede Geliştirici Başvurusu'nu seçin ve arama kutusuna bir veya birden çok terim yazın.
Bu örnekte bir tarih alınır ve DatePart işlevi kullanıldığında, tarihin geçtiği yılın çeyreği görüntülenir.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg