DATETIMEVALUE, funkcja ER
Funkcja DATETIMEVALUE zwraca wartość Data/godzina, która jest konwertowana z danej wartości tekstowej w określonym formacie i opcjonalnie określonej kulturze na wartość daty/godziny. Aby uzyskać informacje na temat obsługiwanych formatów, zobacz formaty standardowe i niestandardowe.
Składnia 1
DATETIMEVALUE (text, format)
Składnia 2
DATETIMEVALUE (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/godzina
Wyjściowa wartość daty/godziny.
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 DATETIMEVALUE 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 DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") zwraca datę 2:55:00 21 grudnia 2016 roku zgodnie z określonym formatem niestandardowym i domyślną kulturą EN-US aplikacji.
Przykład 2
Funkcja DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") zwraca 2:55:00 21 grudnia 2016 na podstawie określonego formatu niestandardowego i kultury.
Natomiast funkcja DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") zgłasza wyjątek w celu poinformowania użytkownika, że podany ciąg nie został rozpoznany jako prawidłowa wartość daty/godziny dla określonej kultury.