Zwraca wartość typu wariant (liczba całkowita) zawierającą określoną część danej daty.
| Ostrzeżenie Wystąpił problem z użyciem tej funkcji. Ostatni poniedziałek w niektórych latach kalendarzowych może zostać zwrócony jako tydzień 53, podczas gdy powinien to być tydzień 1. Aby uzyskać więcej informacji i obejść ten problem, zobacz Funkcje Format lub DatePart mogą zwrócić nieprawidłowy numer tygodnia dla ostatniego poniedziałku w roku. |
|---|
Składnia
DatePart(interval; date [, firstday_week] [, firstweek_year])
W składni funkcji DatePart występują następujące argumenty:
| Argumenty argumentów | Opis |
|---|---|
| Interwał | Argument wymagany. Wyrażenie ciągu będące zwracanym interwałem czasu. |
| DATA | Argument wymagany. Wariant (data), która ma zostać obliczona. |
| pierwszy dzień tygodnia | Argument opcjonalny. Stała określająca pierwszy dzień tygodnia. Jeśli nie zostanie określona, za niedzielę przyjmuje się niedzielę. |
| pierwszy tydzień_roku | Argument opcjonalny. Stała określająca pierwszy tydzień roku. Jeśli nie zostanie określony, przyjmuje się, że pierwszy tydzień to ten, w którym występuje 1 stycznia. |
Ustawienia
Argument interwału 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 |
| s | Sekunda |
Argument pierwszy_dzień_tygodnia ma następujące ustawienia:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseSystem | 0 | Użyj ustawienia interfejsu API funkcji NLS. |
| vbSunday | 1 | Niedziela (domyślnie) |
| vbMonday | 2 | Poniedziałek |
| vbwtorek | 3 | Wtorek |
| vbWednesday | 4 | Środa |
| vbczwartek | 5 | Czwartek |
| vbFriday | 6 | Piątek |
| vbSaturday | 7 | Sobota |
Argument pierwszy_tydzień_roku ma następujące ustawienia:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseSystem | 0 | Użyj ustawienia interfejsu API funkcji 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. |
Uwagi
Funkcja DatePart służy do obliczania daty i zwracania określonego interwału czasu. Funkcji Składnik.daty można na przykład użyć do obliczenia dnia tygodnia lub bieżącej godziny.
Argument pierwszy_dzień_tygodnia wpływa na obliczenia, w których są używane symbole interwałów "w" i "ww".
Jeśli data jest literałem daty, określony rok staje się stałą częścią tej daty. Jeśli jednak data jest ujęta w podwójny cudzysłów (" ") i rok zostanie pominięty, to bieżący rok będzie wstawiany do kodu za każdym razem, gdy obliczane jest wyrażenie daty . Dzięki temu możliwe jest pisanie kodu, który może być używany w różnych latach.
Uwaga
W przypadku daty, jeśli ustawieniem właściwości Kalendarz jest kalendarz gregoriański, podana data musi być gregoriańska. Jeśli kalendarz jest kalendarzem Hidżry, podana data musi być kalendarzem Hidżra.
Zwracana część daty jest wyrażona w jednostkach okresu bieżącego kalendarza arabskiego. Jeśli na przykład bieżący kalendarz jest kalendarzem Hidżry, a częścią daty, która ma być zwrócona, jest rok, wartość roku jest rokiem kalendarza Hidżry.
Przykłady kwerend
| Wyrażenie | Rezultat |
|---|---|
| SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca rok wartości dat pola "DataSprzedaży". |
| SELECT DatePart("q",[DataSprzedaży]) AS NewDate FROM SprzedażProduktów; | Zwraca kwartał (na podstawie roku kalendarza) wartości dat pola "DataSprzedaży". |
| SELECT DatePart("y",[DataSprzedaży]) AS NewDate FROM SprzedażProduktów; | Zwraca dzień roku (od 1 do 365) wartości dat pola "DataSprzedaży". |
| SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca "dzień" wartości dat w polu "DataSprzedaży". |
| SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca "Dzień tygodnia" (od 1 do 7, gdzie 1 oznacza niedzielę) wartości dat pola "DataSprzedaży". |
| SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca numer tygodnia (od 1 do 52) wartości dat pola "DataSprzedaży". |
| SELECT DatePart("h",[Data_godzina]) AS NewDate FROM SprzedażProduktów; | Zwraca wartość godziny wartości daty w polu "DateTime". |
| SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; | Zwraca minuty dla wartości daty pola "DateTime". |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | Zwraca sekundy wartości dat pola "DateTime". |
Przykład kodu 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 przyjmuje datę i za pomocą funkcji DatePart wyświetla kwartał roku, w którym występuje datę.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg