Przejdź do głównej zawartości

Date.ToText

Zwraca tekstową reprezentację wartości daty.

Syntax​

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

Remarks​

Zwraca tekstową reprezentację właściwości date. Aby określić dodatkowe właściwości można podać opcjonalny parametr rekordu, options. culture stosuje się tylko w starszych przepływach pracy (zobacz poniżej). Parametr rekordu może zawierać następujące pola:

  • Format: wartość tekstowa wskazująca format, który ma być użyty. Aby uzyskać więcej szczegółów, przejdź do strony https://go.microsoft.com/fwlink/?linkid=2180104 i https://go.microsoft.com/fwlink/?linkid=2180105. Pominięcie tego pola lub podanie wartości null spowoduje sformatowanie daty przy użyciu wartości domyślnej zdefiniowanej przez parametr Culture.
  • Culture: gdy parametr Format nie ma wartości null, parametr Culture kontroluje niektóre specyfikatory formatu. Na przykład w przypadku parametru „en-US” format „MMM” ma wartości „Jan”, „Feb”, „Mar”, ..., natomiast w przypadku parametru „ru-RU”format„MMM” ma wartości „янв”, „фев”, „мар”, .... Gdy parametr Format ma wartość null, parametr Culture kontroluje domyślny format, który ma być użyty. Gdy parametr Culture ma wartość null lub jest pominięty, zostanie użyta funkcja Culture.Current.
Aby obsługiwać starsze przepływy pracy, wartościami tekstowymi mogą być również options i culture. Zachowanie jest takie same jak w przypadku options = [Format = options, Culture= culture].

Examples​

Example #1​

Przekonwertuj wartość <code>#date(2010, 12, 31)</code> na wartość <code>„text”</code>. <i>Wynik może się różnić w zależności od aktualnej kultury.</i>

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

Result:

"12/31/2010"

Example #2​

Konwertuj przy użyciu formatu niestandardowego i z kulturą Polska — polski.

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

Result:

"31 Dez 2010"

Example #3​

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

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

Result:

"1420"

Category​

Date