Funkcja DATE
Zwraca określoną datę w formacie datetime.
Składnia
DATE(<year>, <month>, <day>)
Parametry
Termin |
Definicja |
|---|---|
year |
Liczba przedstawiająca rok. Wartość argumentu year może się składać z 1–4 cyfr. Argument year jest interpretowany zgodnie z systemem dat używanym na komputerze. Obsługiwane są daty od 1 marca 1900 roku. W przypadku wprowadzenia liczby zawierającej miejsca dziesiętne jest ona zaokrąglana. W przypadku wartości większych niż 9999 lub mniejszych niż zero (wartości ujemne) funkcja zwraca błąd #ARG!. Jeśli wartość argumentu rok należy do przedziału od 0 do 1899, jest dodawana do wartości 1900 w celu utworzenia finalnej wartości. Zobacz przykłady poniżej.
|
month |
Liczba przedstawiająca miesiąc lub obliczenie zgodne z następującymi regułami: Jeśli wartość argumentu month jest liczbą z przedziału od 1 do 12, przedstawia miesiąc w roku. Liczba 1 reprezentuje styczeń, liczba 2 reprezentuje luty, a liczba 12 reprezentuje grudzień. Jeśli zostanie wprowadzona liczba całkowita większa niż 12, zostanie wykonane następujące obliczenie: data jest obliczana przez dodanie wartości argumentu month do wartości argumentu year. Na przykład użycie funkcji DATE( 2008, 18, 1) spowoduje zwrócenie wartości daty/godziny odpowiadającej dacie 1 czerwca 2009 roku, ponieważ do początku roku 2008 zostanie dodanych 18 miesięcy, co w wyniku da czerwiec 2009 roku. Zobacz przykłady poniżej. Jeśli zostanie wprowadzona ujemna liczba całkowita, zostanie wykonane następujące obliczenie: data jest obliczana przez odjęcie wartości argumentu month od wartości argumentu year. Na przykład użycie funkcji DATE( 2008, -6, 15) spowoduje zwrócenie wartości daty/godziny odpowiadającej dacie 15 czerwca 2007 roku, ponieważ od początku roku 2008 zostanie odjętych 6 miesięcy, co w wyniku da czerwiec 2007 roku. Zobacz przykłady poniżej. |
day |
Liczba przedstawiająca dzień lub obliczenie zgodne z następującymi regułami: Jeśli wartość argumentu day jest liczbą z przedziału od 1 do ostatniego dnia danego miesiąca, przedstawia dzień w miesiącu. Jeśli zostanie wprowadzona liczba całkowita większa niż ostatni dzień danego miesiąca, zostanie wykonane następujące obliczenie: data jest obliczana przez dodanie wartości argumentu day do wartości argumentu month. Na przykład użycie funkcji DATE w formule DATE( 2008, 3, 32) spowoduje zwrócenie wartości typu datetime odpowiadającej dacie 1 kwietnia 2008 roku, ponieważ do początku marca zostaną dodane 32 dni, co w wyniku da 1 kwietnia. Jeśli zostanie wprowadzona ujemna liczba całkowita, zostanie wykonane następujące obliczenie: data jest obliczana przez odjęcie wartości argumentu day od wartości argumentu month. Na przykład użycie funkcji DATE w formule DATE( 2008, 5, -15) spowoduje zwrócenie wartości typu datetime odpowiadającej dacie 15 kwietnia 2008 roku, ponieważ od początku maja 2008 roku zostanie odjętych 15 dni, co w wyniku da wartość kwiecień 2008 roku. Jeśli wartość argumentu day zawiera część dziesiętną, jest zaokrąglana do najbliższej liczby całkowitej. |
Wartość zwracana
Zwraca określoną datę (datetime)).
Uwagi
Funkcja DATE przyjmuje jako argumenty liczby całkowite i generuje odpowiednią datę. Funkcja DATE jest najbardziej przydatna w sytuacjach, gdy rok, miesiąc i dzień są podawane przez formuły. Na przykład dane źródłowe mogą zawierać daty w formacie, który nie jest rozpoznawany jako data, takim jak RRRRMMDD. Funkcji DATE można użyć w połączeniu z innymi funkcjami, aby przekonwertować datę na liczbę, która może być rozpoznana jako data.
W odróżnieniu od programu Microsoft Excel, w którym daty są przechowywane jako liczby seryjne, funkcje daty programu języka DAX zawsze zwracają dane typu datetime. W razie potrzeby można jednak użyć formatowania w celu wyświetlenia dat jako liczb seryjnych.
Ta funkcja języka DAX może zwracać inne wyniki w przypadku użycia jej w modelu, który został wdrożony i do którego skierowano następnie zapytanie w trybie zapytania bezpośredniego. Aby uzyskać więcej informacji o różnicach semantycznych w trybie zapytania bezpośredniego, zobacz https://go.microsoft.com/fwlink/?LinkId=219171.
Przykład: zwracanie prostej daty
Opis
Poniższa formuła zwraca datę 8 lipca 2009 roku:
Kod
=DATE(2009,7,8)
Przykład: lata przed rokiem 1899
Opis
Jeśli wartość wprowadzona jako argument year jest z zakresu od 0 (zero) do 1899 (włącznie), w celu obliczenia roku zostaje ona dodana do wartości 1900. Poniższa formuła zwraca datę 2 stycznia 1908 roku: (1900+08).
Kod
=DATE(08,1,2)
Przykład: lata przed rokiem 1899
Opis
Jeśli wartość wprowadzona jako argument year jest z zakresu od 0 (zero) do 1899 (włącznie), w celu obliczenia roku zostaje ona dodana do wartości 1900. Poniższa formuła zwraca datę 2 stycznia 3700 roku: (1900+1800).
Kod
=DATE(1800,1,2)
Przykład: lata po roku 1899
Opis
Jeśli argument year jest z zakresu od 1900 do 9999 (włącznie), podana wartość jest używana jako rok. Poniższa formuła zwraca datę 2 stycznia 1908 roku:
Kod
=DATE(2008,1,2)
Przykład: praca z użyciem miesięcy
Opis
Jeśli wartość argumentu month jest większa niż 12, wartość argumentu month jest dodawana jako liczba miesięcy do pierwszego miesiąca określonego roku. Poniższa formuła zwraca datę 2 lutego 2009 roku:
Kod
=DATE(2008,14,2)
Komentarz
Jeśli wartość argumentu month jest mniejsza niż 1, funkcja DATE odejmuje daną liczbę miesięcy powiększoną o 1 od pierwszego miesiąca określonego roku. Poniższa formuła zwraca datę 2 września 2007 roku:
=DATE(2008,-3,2)
Przykład: praca z użyciem dni
Opis
Jeśli wartość argumentu day jest większa niż liczba dni w określonym miesiącu, wartość argumentu day jest dodawana jako liczba dni do pierwszego dnia w miesiącu. Poniższa formuła zwraca datę 4 lutego 2008 roku:
Kod
=DATE(2008,1,35)
Komentarz
Jeśli wartość argumentu day jest mniejsza niż 1, wartość argumentu day powiększona o 1 jest odejmowana od pierwszego dnia w określonym miesiącu. Poniższa formuła zwraca datę 16 grudnia 2007 roku:
=DATE(2008,1,-15)