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.

Dodatkowe zasoby

Funkcje daty i godziny