Перейти к основному содержимому

DateTime.FromText

Создает значение datetimezone из локальных и всеобщих форматов даты и времени.

Syntax

DateTime.FromText(
text as text,
optional options as any
) as datetime

Remarks

Создает значение datetime из текстового представления text. При необходимости можно задать необязательный параметр options типа record для указания дополнительных свойств. В состав 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].

Examples

Example #1

Преобразование <code>"2010-12-31T01:30:00"</code> в значение даты и времени.

DateTime.FromText("2010-12-31T01:30:25")

Result:

#datetime(2010, 12, 31, 1, 30, 25)

Example #2

Преобразование <code>"2010-12-31T01:30:00.121212"</code> в значение даты и времени.

DateTime.FromText("30 Dez 2010 02:04:50.369730", [Format="dd MMM yyyy HH:mm:ss.ffffff", Culture="de-DE"])

Result:

#datetime(2010, 12, 30, 2, 4, 50.36973)

Example #3

Преобразование <code>"2010-12-31T01:30:00"</code> в значение даты и времени.

DateTime.FromText("2000-02-08T03:45:12Z", [Format="yyyy-MM-dd'T'HH:mm:ss'Z'", Culture="en-US"])

Result:

#datetime(2000, 2, 8, 3, 45, 12)

Example #4

Преобразование <code>"20101231T013000"</code> в значение даты и времени.

DateTime.FromText("20101231T013000", [Format="yyyyMMdd'T'HHmmss", Culture="en-US"])

Result:

#datetime(2010, 12, 31, 1, 30, 0)

Category

DateTime