Funkcja DatePart

Zwraca wartość typu wariant (liczba całkowita) zawierającą określoną część danej daty.

Ostrzeżenie    Wystąpił problem z korzystaniem z tej funkcji. Ostatni poniedziałek w kilku latach kalendarzowych można zwrócić jako tydzień 53, gdy powinien to być tydzień 1. Aby uzyskać więcej informacji i obejście, zobacz funkcje format lub datepart mogą zwracać nieprawidłowy numer tygodnia w ubiegłym poniedziałek roku.

Składnia

DatePart ( interwał, Data [, pierwszydzieńtygodnia] [, FirstWeekOfYear] )

W składni funkcji DatePart występują następujące argumenty:

Argument

Opis

interval

Argument wymagany. Wyrażenie tekstowe, które jest interwałem czasu, który ma zostać zwrócony.

date

Argument wymagany. Variant (Date) wartość, którą chcesz oszacować.

pierwszydzieńtygodnia

Argument opcjonalny. stała, który określa pierwszy dzień tygodnia. Jeśli argument nie zostanie określony, przyjmowana jest niedziela.

firstweekofyear

Argument opcjonalny. Stała określająca pierwszy tydzień roku. Jeśli nie określono tego pola, przyjmuje się, że pierwszy tydzień przypada na tydzień, w którym występuje 1 stycznia.

Ustawienia

Argument Interwał ma następujące ustawienia:

Ustawienie

Opis

rrrr

Rok

q

Kwartał

m

Miesiąc

y

Dzień roku

d

Dzień

w

Weekday

ww

Tydzień

g

Godzina

n

Minuta

e

Sekunda

Argument pierwszydzieńtygodnia ma następujące ustawienia:

Stała

Wartość

Opis

vbUseSystem

0

Użyj ustawienia API NLS.

vbSunday

1

Niedziela (domyślnie)

vbMonday

2

Poniedziałek

vbTuesday

3

Wtorek

vbWednesday

4

Środa

vbThursday

5

Czwartek

vbFriday

6

Piątek

vbSaturday

7

Sobota

Argument FirstWeekOfYear ma następujące ustawienia:

Stała

Wartość

Opis

vbUseSystem

0

Użyj ustawienia API NLS.

vbFirstJan1

1

Zacznij od tygodnia, w którym występuje 1 stycznia (domyślnie).

vbFirstFourDays

2

Zacznij od pierwszego tygodnia, który ma co najmniej cztery dni w nowym roku.

vbFirstFullWeek

3

Zacznij od pierwszego pełnego tygodnia roku.

Spostrzeżenia

Za pomocą funkcji DatePart można oceniać daty i zwracać określony przedział czasu. Na przykład za pomocą funkcji DatePart możesz obliczyć dzień tygodnia lub bieżącą godzinę.

Argument pierwszydzieńtygodnia wpływa na obliczenia używające symboli interwałów "w" i "ww".

Jeśli dato literał daty , określony rok staje się stałą częścią tej daty. Jeśli jednak Data jest ujęta w podwójny cudzysłów ("") i pominięto rok, w kodzie jest wstawiany bieżący rok. Umożliwia to napisanie kodu, który może być wykorzystywany w różnych latach.

Uwaga: W przypadku daty, jeśli właściwość Calendar jest ustawiona na kalendarz gregoriański, dostarczona Data musi być w formacie kalendarza gregoriańskiego. Jeśli jest używany kalendarz Hidżry, dostarczona Data musi być w formacie kalendarza Hidżry.

Zwrócona część daty jest w jednostkach czasu bieżącego kalendarza arabskiego. Jeśli na przykład bieżącym kalendarzem jest Hidżra, a część daty, która ma zostać zwrócona, jest rokiem w kalendarzu Hidżry.

Przykłady zapytań

Wyrażenie

Wyniki

Wybierz pozycję DatePart ("RRRR"; [DateofSale]) jako NewDate z ProductSales;

Zwraca wartość "rok" wartości daty w polu "DateofSale".

Wybierz pozycję DatePart ("q"; [DateofSale]) jako NewDate z ProductSales;

Zwraca wartość "kwartał" (na podstawie roku kalendarzowego) wartości daty w polu "DateofSale".

Wybierz pozycję DatePart ("y"; [DateofSale]) jako NewDate z ProductSales;

Zwraca wartość "dzień roku" (od 1 do 365) wartości daty w polu "DateofSale".

Wybierz pozycję DatePart ("d", [DateofSale]) jako NewDate z ProductSales;

Zwraca wartość daty "dzień" pola "DateofSale".

Wybierz pozycję DatePart ("w"; [DateofSale]) jako NewDate z ProductSales;

Zwraca wartość "dzień. tyg" (od 1 do 7, gdzie 1 oznacza niedzielę) wartości daty w polu "DateofSale".

Wybierz pozycję DatePart ("ww"; [DateofSale]) jako NewDate z ProductSales;

Zwraca wartość "numer tygodnia" (od 1 do 52) wartości daty w polu "DateofSale".

Wybierz pozycję DatePart ("h"; [DateTime]) jako NewDate z ProductSales;

Zwraca wartość "godzina" wartości daty w polu "DateTime".

Wybierz pozycję DatePart ("n"; [DateTime]) jako NewDate z ProductSales;

Zwraca wartość "minut" wartości dat dla pola "DateTime".

Wybierz pozycję DatePart ("s", [DateTime]) jako NewDate z ProductSales;

Zwraca wartość "s" wartości daty w polu "DateTime".

Przykład języka VBA

Uwaga: Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA). Aby uzyskać dodatkowe informacje na temat pracy w języku VBA, wybierz pozycję Dokumentacja dewelopera z listy rozwijanej obok przycisku Wyszukaj i wprowadź odpowiednie terminy w polu wyszukiwania.

W tym przykładzie jest pobierana Data, a przy użyciu funkcji DatePart jest wyświetlany kwartał roku, w którym występuje.

Dim TheDate As Date    ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Zobacz też

Wybieranie odpowiedniej funkcji daty

Rozwijaj umiejętności związane z pakietem Office
Poznaj szkolenia
Uzyskuj nowe funkcje w pierwszej kolejności
Dołącz do niejawnych testerów pakietu Office

Czy te informacje były pomocne?

Dziękujemy za opinię!

Dziękujemy za opinię! Wygląda na to, że połączenie Cię z jednym z naszych agentów pomocy technicznej pakietu Office może być pomocne.

×