Date.ToText

  • [アーティクル]

構文

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

バージョン情報

date のテキスト表現を返します。 省略可能な record パラメーターの options を指定すると、プロパティを追加指定できます。 culture はレガシ ワークフローでのみ使用されます。 record には、次のフィールドを含めることができます。

  • Format: 使用する形式を示す text 値。 詳細については、「https://go.microsoft.com/fwlink/?linkid=2180104」と「https://go.microsoft.com/fwlink/?linkid=2180105」を参照してください。 このフィールドを省略するか、null を指定すると、日付は Culture で定義した既定値を使用して書式設定されます。

  • Culture: Format が null でない場合、書式指定子の一部は Culture によって制御されます。 たとえば、"en-US" の "MMM" は "Jan", "Feb", "Mar", ... になり、"ru-RU" の "MMM" は "янв", "фев", "мар", ... になります。 Format が null の場合、使用する既定の書式は Culture によって制御されます。 Culture が null であるか省略された場合、Culture.Current が使用されます。

レガシ ワークフローをサポートするために、options と culture をテキスト値にすることもできます。 これは options = [Format = options, Culture = culture] と同じ動作をします。

例 1

#date(2010, 12, 31) を text 値に変換します。 結果の出力は、現在のカルチャによって異なります。

使用方法

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

出力

"12/31/2010"

例 2

カスタム形式とドイツ語のカルチャを使用して変換します。

使用方法

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

出力

"31 Dez 2010"

例 3

グレゴリオ暦の 2000 年 1 月 1 日に対応するイスラム暦の年を探します。

使用方法

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

出力

"1420"