Date.FromText

構文

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

バージョン情報

テキスト表現 text から date の値を作成します。 省略可能な record パラメーターの options を指定すると、プロパティを追加指定できます。 record には、次のフィールドを含めることができます。

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

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

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

例 1

"2010-12-31" を date 値に変換します。

使用方法

Date.FromText("2010-12-31")

出力

#date(2010, 12, 31)

例 2

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

使用方法

Date.FromText("30 Dez 2010", [Format="dd MMM yyyy", Culture="de-DE"])

出力

#date(2010, 12, 30)

例 3

イスラム暦の 1400 年の開始に対応するグレゴリオ暦の日付を探します。

使用方法

Date.FromText("1400", [Format="yyyy", Culture="ar-SA"])

出力

#date(1979, 11, 20)