DATETIMEFORMAT, funkcja ER
Funkcja DATETIMEFORMAT zwraca wartość Ciąg, która przedstawia daną wartość daty/godziny jako tekst w określonym formacie i opcjonalnie określonej kulturze. Aby uzyskać informacje na temat obsługiwanych formatów, zobacz formaty standardowe i niestandardowe.
Składnia 1
DATETIMEFORMAT (datetime, format)
Składnia 2
DATETIMEFORMAT (datetime, format, culture)
Argumenty
datetime: Data/godzina
Wartość daty i godziny, która reprezentuje datę i godzinę do sformatowania.
format: Ciąg
Format ciągu wyjściowego. Aby uzyskać informacje na temat obsługiwanych formatów, zobacz formaty standardowe i niestandardowe.
Banknot
W przypadku używania formatu standardowego lub niestandardowego w ciągu formatu jest uwzględniana wielkość liter. Na przykład standardowy format „d” zwraca datę przy użyciu wzorca daty krótkiej, a standardowy modyfikator formatu „D” zwraca datę przy użyciu wzorca daty długiej. Ponadto niestandardowy modyfikator formatu „M” zwraca miesiąc z okresu od 1 do 12, podczas gdy niestandardowy modyfikator formatu „m” zwraca minuty od 0 do 59.
culture: Ciąg
Kultura do użycia na potrzeby formatowania. Aby uzyskać informacje o obsługiwanych kulturach, zobacz temat Kultura.
Wartości zwracane
Ciąg
Wyjściowa wartość ciągu.
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 DATETIMEFORMAT 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.
Gdy funkcja DATETIMEFORMAT konwertuje wartość danej daty/godziny, bierze pod uwagę ustawienia strefy czasowej użytkownika aplikacji, który uruchamia format ER, w którego kontekście jest wywoływana funkcja.
Przykład 1
Funkcja DATETIMEFORMAT (NOW(), "dd-MM-yyyy") zwraca wartość daty/godziny bieżącego serwera aplikacji, 24 grudnia 2015 roku, jako "24-12-2015", zgodnie z określonym formatem niestandardowym.
Przykład 2
Funkcja DATETIMEFORMAT (SESSIONNOW(), "d", "DE") zwraca bieżącą datę/godzinę sesji aplikacji, 24 grudnia 2015, jako ciąg „24.12.2015”, na podstawie wybranej kultury niemieckiej i określonego formatu.
Przykład 3
Funkcja DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") zwraca wartość ciągu 2019-11-12T08:00:00.0000000-08:00, gdy funkcja jest wywoływana podczas procesu, który został zainicjowany przez użytkownika aplikacji z wartością strefy czasowej (GMT-08:00) Czas pacyficzny (USA i Kanada) w sekcji Preferencje dotyczące języka i kraju/regionu.