Date.ToText

日付値のテキスト形式の表記を返します。

Syntax

Date.ToText(
    date as date,
    optional options as any,
    optional culture as text
) as 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] の場合と動作が同じになります。

<code>#date(2010, 12, 31)</code> を <code>text</code> 値に変換します。<i>結果出力が現在のカルチャに応じて異なる場合があります。</i>

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

Result:

"12/31/2010"

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

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

Result:

"31 Dez 2010"

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

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

Result:

"1420"