メインコンテンツまでスキップ

Date.ToText

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

Syntax​

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

Remarks​

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] の場合と同じ動作になります。

Examples​

Example #1​

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

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

Result:

"12/31/2010"

Example #2​

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

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

Result:

"31 Dez 2010"

Example #3​

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

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

Result:

"1420"

Category​

Date