DATEVALUE, funkcja ER
Funkcja DATEVALUE zwraca wartość daty, która jest konwertowana z wartości danego tekstu w określonym formacie i opcjonalnie określonej kulturze na wartość daty. Aby uzyskać informacje na temat obsługiwanych formatów, zobacz formaty standardowe i niestandardowe.
Składnia 1
DATEVALUE (text, format)
Składnia 2
DATEVALUE (text, format, culture)
Argumenty
text: Ciąg
Tekst reprezentujący wartość do sformatowania.
format: Ciąg
Format danego tekstu. Aby uzyskać informacje na temat obsługiwanych formatów, zobacz formaty standardowe i niestandardowe.
culture: Ciąg
Kultura używana do formatowania danego tekstu. Aby uzyskać informacje o obsługiwanych kulturach, zobacz temat Kultura.
Wartości zwracane
Data
Wyjściowa wartość daty.
Uwagi dotyczące użytkowania
Gdy kultura nie jest zdefiniowana jako argument wywołanej funkcji, wartość culture jest definiowana przez kontekst wywołujący. Jeśli na przykład funkcja DATEVALUE jest wywoływana przy użyciu składni 1 w formacie raportowania elektronicznego (ER) dla elementu PLIK, który jest skonfigurowany do używania kultury niemieckiej, konwersja zostanie wykonana przy użyciu kultury niemieckiej. Domyślna wartość culture to EN-US.
Przykład 1
Funkcja DATEVALUE ("21-Dec-2016", "dd-MMM-yyyy") zwraca datę 21 grudnia 2016 roku zgodnie z określonym formatem niestandardowym i domyślną kulturą EN-US aplikacji.
Przykład 2
Funkcja DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "IT") zwraca wartość daty 21 stycznia 2016 na podstawie określonego formatu niestandardowego i kultury.
Natomiast funkcja DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "EN-US") zgłasza wyjątek w celu poinformowania użytkownika, że podany ciąg nie został rozpoznany jako prawidłowa data.