Date.FromText

現地、世界共通、カスタムの日付の形式から日付を作成します。

Syntax

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

<code>"2010-12-31"</code> を <code>date</code> 値に変換します。

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

Result:

#date(2010, 12, 31)

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

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

Result:

#date(2010, 12, 30)

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

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

Result:

#date(1979, 11, 20)