Przejdź do głównej zawartości

DateTime.ToText

Zwraca tekstową reprezentację wartości typu datetime.

Syntax​

DateTime.ToText(
    dateTime as datetime,
    optional options as any,
    optional culture as text
) as text

Remarks​

Zwraca tekstową reprezentację właściwości dateTime. 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>#datetime(2010, 12, 31, 01, 30, 25)</code> na wartość <code>„text”</code>. <i>Wynik może się różnić w zależności od aktualnej kultury.</i>

DateTime.ToText(#datetime(2010, 12, 31, 01, 30, 25))

Result:

"12/31/2010 1:30:25 AM"

Example #2​

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

DateTime.ToText(#datetime(2010, 12, 30, 2, 4, 50.36973), [Format="dd MMM yyyy HH:mm:ss.ffffff", Culture="de-DE"])

Result:

"30 Dez 2010 02:04:50.369730"

Example #3​

Konwertuj przy użyciu wzorca ISO 8601.

DateTime.ToText(#datetime(2000, 2, 8, 3, 45, 12),[Format="yyyy-MM-dd'T'HH:mm:ss'Z'", Culture="en-US"])

Result:

"2000-02-08T03:45:12Z"

Category​

DateTime