Przejdź do głównej zawartości

Date.FromText

Tworzy wartość „date” na podstawie lokalnych, uniwersalnych i niestandardowych formatów wartości „date”.

Syntax​

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

Remarks​

Tworzy wartość typu date z tekstowej reprezentacji, text. Aby określić dodatkowe właściwości można podać opcjonalny parametr rekordu, options. Parametr rekordu może zawierać następujące pola:

  • Format: wartość tekstowa wskazująca format, który ma być użyty. Aby uzyskać więcej szczegółów, przejdź do strony https://go.microsoft.com/fwlink/?linkid=2180104 i https://go.microsoft.com/fwlink/?linkid=2180105. Pominięcie tego pola lub podanie wartości null spowoduje analizę daty przy użyciu optymalnego rozwiązania.
  • Culture: gdy parametr Format nie ma wartości null, parametr Culture kontroluje niektóre specyfikatory formatu. Na przykład w przypadku parametru „en-US” format „MMM” ma wartości „Jan”, „Feb”, „Mar”, ..., natomiast w przypadku parametru „ru-RU”format„MMM” ma wartości „янв”, „фев”, „мар”, .... Gdy parametr Format ma wartość null, parametr Culture kontroluje domyślny format, który ma być użyty. Gdy parametr Culture ma wartość null lub jest pominięty, zostanie użyta funkcja Culture.Current.
Aby obsługiwać starsze przepływy pracy, wartościami tekstowymi mogą być również options. Zachowanie jest takie same jak w przypadku options = [Format = null, Culture = options].

Examples​

Example #1​

Przekonwertuj wartość <code>"2010-12-31"</code> na wartość typu <code>date</code>.

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

Result:

#date(2010, 12, 31)

Example #2​

Konwertuj przy użyciu formatu niestandardowego i z kulturą Polska — polski.

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

Result:

#date(2010, 12, 30)

Example #3​

Znajdź w kalendarzu gregoriańskim datę odpowiadającą początkowi 1400 roku w kalendarzu Hidżry.

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

Result:

#date(1979, 11, 20)

Category​

Date