Zwraca wartość typu wariant (liczba całkowita) zawierającą określoną część danej daty.
| Ostrzeżenie Występuje problem z używaniem tej funkcji. Ostatni poniedziałek w niektórych latach kalendarzowych można zwrócić jako tydzień 53, kiedy powinien to być tydzień 1. Aby uzyskać więcej informacji i obejść ten problem, zobacz Funkcje Format lub DatePart mogą zwracać nieprawidłowy numer tygodnia dla ostatniego poniedziałku w roku. |
|---|
Składnia
DatePart(interval, date [, firstdayofweek] [, firstweekofyear] )
W składni funkcji DatePart występują następujące argumenty:
| Argument | Opis |
|---|---|
| Interwał | Argument wymagany. Wyrażenie ciągu będące interwałem, który ma zostać zwrócony. |
| Data | Argument wymagany. Wartość typu wariant (data), która ma zostać obliczona. |
| Firstdayofweek | Argument opcjonalny. Stała określająca pierwszy dzień tygodnia. Jeśli nie określono, przyjmuje się, że niedziela. |
| firstweekofyear | Argument opcjonalny. Stała określająca pierwszy tydzień roku. Jeśli nie określono, przyjmuje się, że pierwszy tydzień jest tygodniem, 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 zawiera następujące ustawienia:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseSystem | 0 | Użyj ustawienia interfejsu 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 pierwszy_tydzień_roku ma następujące ustawienia:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseSystem | 0 | Użyj ustawienia interfejsu API NLS. |
| vbFirstJan1 | 1 | Rozpocznij 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 umożliwia ocenę daty i zwrócenie określonego interwału czasu. Za pomocą funkcji DatePart można na przykład obliczyć dzień tygodnia lub bieżącą godzinę.
Argument pierwszy_dzień_tygodnia wpływa na obliczenia używające symboli 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 (" "), a rok zostanie pominięty, bieżący rok zostanie wstawiony do kodu przy każdej ocenie wyrażenia daty . Umożliwia to pisanie kodu, którego można używać w różnych latach.
Uwaga
Na dzień, jeśli ustawieniem właściwości Calendar jest gregoriański, podanej datą musi być gregoriański. Jeśli kalendarz to Hidżry, podana data musi mieć wartość Hidżry.
Zwracana część daty znajduje się w jednostkach okresu bieżącego kalendarza arabskiego. Jeśli na przykład bieżącym kalendarzem jest Hidżry, a częścią daty, która ma zostać zwrócona, jest rok, wartość roku to rok Hidżry.
Przykłady zapytań
| Wyrażenie | Rezultat |
|---|---|
| SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wartość 'Rok' dla wartości dat pola "DateofSale". |
| SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wartość "Kwartał" (na podstawie roku kalendarzowego) wartości dat pola "DateofSale". |
| SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wartość "Dzień roku" (od 1 do 365) wartości dat pola "DateofSale". |
| SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wartość 'Dzień' wartości dat pola "DateofSale". |
| SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wartość "Dzień tygodnia" (od 1 do 7, gdzie 1 oznacza niedzielę) wartości dat pola "DateofSale". |
| SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | Zwraca wartość "Numer tygodnia" (od 1 do 52) wartości dat pola "DateofSale". |
| SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | Zwraca wartość "Hour" wartości dat pola "DateTime". |
| SELECT DatePart("n";[DateTime]) AS NewDate FROM ProductSales; | Zwraca wartość "Min" wartości dat pola "DateTime". |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | Zwraca "sekundy" wartości dat pola "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.
Ten przykład przyjmuje datę i za pomocą funkcji DatePart wyświetla 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