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ındaki son Pazartesi, 1. hafta olması gerektiğinde 53. hafta olarak döndürülebilir. Daha fazla bilgi ve geçici çözüm için bkz. Format veya DatePart işlevleri yılın son Pazartesi günü için yanlış hafta numarası döndürebilir. |
Söz dizimi
DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )
DatePart işlevinin söz diziminde şu bağımsız değişkenler bulunur:
|
Bağımsız değişken |
Açıklama |
|
aralık |
Gerekli. Döndürmek istediğiniz zaman aralığı olan dize ifadesi. |
|
date |
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 bir 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 şu 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şkeni şu ayarlara sahiptir:
|
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 |
|
vbSaturday |
7 |
Cumartesi |
İlk haftanın bağımsız değişkeni şu ayarlara sahiptir:
|
Sabit |
Değer |
Açıklama |
|
vbUseSystem |
0 |
NLS API ayarını kullanın. |
|
vbFirstJan1 |
1 |
1 Ocak'ın gerçekleştiği haftayla başlayın (varsayılan). |
|
vbFirstFourDays |
2 |
Yeni yılda en az dört günü olan ilk hafta ile başlayın. |
|
vbFirstFullWeek |
3 |
Yılın ilk tam haftasıyla başlayın. |
Açıklamalar
Tarihi değerlendirmek 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 simgelerini kullanan hesaplamaları etkiler.
da te bir tarih dizisi ise, belirtilen yıl bu tarihin kalıcı bir parçası olur. Ancak , tarih çift tırnak işareti (" ") içine alınırsa ve yılı atlarsanız, tarih ifadesi her değerlendirildiğinde geçerli yıl kodunuz içine eklenir. Bu, farklı yıllarda kullanılabilecek kod yazmayı mümkün kılar.
Not: Tarih için, Takvim özellik ayarı Gregoryen ise, sağlanan tarih Gregoryen olmalıdır. Takvim Hicri ise, sağlanan tarih Hicri olmalıdır.
Döndürülen tarih bölümü, geçerli Arap takviminin zaman aralığı birimlerindedir. Örneğin, geçerli takvim Hicri ve döndürülecek tarih bölümü yıl ise, yıl değeri hicri yıldır.
Sorgu örnekleri
|
Expression |
Sonuçlar |
|
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" alanının tarih değerlerinin 'Yıl' değerini döndürür. |
|
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" alanının tarih değerlerinin 'Çeyrek' değerini (takvim yılına göre) döndürür. |
|
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ü'nü döndürür. |
|
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" alanının tarih değerlerinin 'Weekday' değerini (1 ile 7(1'in Pazar'ı temsil ettiği) 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) döndürür. |
|
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
"DateTime" alanının tarih değerlerinin 'Saat' değerini döndürür. |
|
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; |
"DateTime" alanının tarih değerlerinin 'Minutes' değerini döndürür. |
|
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; |
"DateTime" alanının tarih değerlerinin 'saniyelerini' 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 örnek bir tarih alır ve DatePart işlevini kullanarak gerçekleştiği yılın üç aylık dönemini görüntüler.
Dim TheDate As Date ' Declare variables.Dim Msg TheDate = InputBox("Enter a date:")Msg = "Quarter: " & DatePart("q", TheDate)MsgBox Msg
