Udostępnij za pośrednictwem


Date.ToText

Składnia

Date.ToText(date as nullable date, optional options as any, optional culture as nullable text) as nullable text

O nas

Zwraca tekstową reprezentację elementu date. Można podać opcjonalny record parametr , optionsaby określić dodatkowe właściwości. culture jest używany tylko w przypadku starszych przepływów pracy. Może record zawierać następujące pola:

  • Format: text wartość wskazująca format do użycia. Aby uzyskać więcej informacji, przejdź do Standardowe ciągi formatu daty i godziny i Niestandardowe ciągi formatu daty i godziny. Pominięcie tego pola lub podanie null spowoduje sformatowanie daty przy użyciu wartości domyślnej zdefiniowanej przez Culture.

  • Culture: Jeśli Format parametr nie ma wartości null, Culture steruje niektórymi specyfikatorami formatu. Na przykład, w "en-US""MMM" jest "Jan", "Feb", "Mar", ..., podczas gdy w "ru-RU""MMM" jest "янв", "фев", "мар", .... Gdy Format ma wartość null, Culture określa domyślny format do użycia. Gdy Culture to null lub jest pominięte, używane jest Culture.Current.

Aby obsługiwać starsze przepływy pracy, options a culture także mogą być wartościami tekstowymi. Ma to takie samo zachowanie, jak w przypadku options = [Format = options, Culture = culture].

Przykład 1

Przekształć #date(2010, 12, 31) na wartość text. Dane wyjściowe wyników mogą się różnić w zależności od bieżącej kultury.

Użycie

Date.ToText(#date(2010, 12, 31))

Wyjście

"12/31/2010"

Przykład 2

Konwertuj, używając niestandardowego formatu i niemieckiej kultury.

Użycie

Date.ToText(#date(2010, 12, 31), [Format="dd MMM yyyy", Culture="de-DE"])

Wyjście

"31 Dez 2010"

Przykład 3

Znajdź rok w kalendarzu Hidżry, który odpowiada 1 stycznia 2000 r. w kalendarzu gregoriańskim.

Użycie

Date.ToText(#date(2000, 1, 1), [Format="yyyy", Culture="ar-SA"])

Wyjście

"1420"