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 |
interval |
Argument wymagany. Wyrażenie ciągu będące interwałem, który ma zostać zwrócony. |
date |
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 |
Value (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 |
Value (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 date jest literał 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: Dla daty, jeśli ustawieniem właściwości Kalendarz 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ń
Expression |
Wyniki |
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