DateTime.ToText
Синтаксис
DateTime.ToText(dateTime as nullable datetime, optional options as any, optional culture as nullable text) as nullable text
О программе
Возвращает текстовое представление dateTime
. Для указания дополнительных свойств может быть предоставлен необязательный параметр record
— options
.
culture
используется только для устаревших рабочих процессов.
record
может содержать следующие поля:
Format
: значениеtext
, указывающее используемый формат. Дополнительные сведения см. в строках формата даты и времени уровня "Стандартный" и строк пользовательского формата даты и времени. В случае пропуска этого поля или указания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]
.
Пример 1
Преобразование #datetime(2010, 12, 31, 01, 30, 25)
в text
значение.
Итоговые выходные данные могут зависеть от текущего языка и региональных параметров.
Использование
DateTime.ToText(#datetime(2010, 12, 31, 01, 30, 25))
Выходные данные
"12/31/2010 1:30:25 AM"
Пример 2
Преобразование с использованием пользовательского формата и немецкого языка и региональных параметров.
Использование
DateTime.ToText(#datetime(2010, 12, 30, 2, 4, 50.36973), [Format="dd MMM yyyy HH:mm:ss.ffffff", Culture="de-DE"])
Выходные данные
"30 Dez 2010 02:04:50.369730"
Пример 3
Преобразование с использованием шаблона ISO 8601.
Использование
DateTime.ToText(#datetime(2000, 2, 8, 3, 45, 12),[Format="yyyy-MM-dd'T'HH:mm:ss'Z'", Culture="en-US"])
Выходные данные
"2000-02-08T03:45:12Z"