dateTimeFormat

Форматирует значение даты и времени, используя форматы даты и времени США. Для поддержки международных форматов дат используйте lsDateTimeFormat.

dateTimeFormat(date [, mask [, timezone]]) → returns string

Синтаксис функции-члена

datetime.dateTimeFormat([mask [, timezone]])

CF10+

Lucee4.5+

BL 1.0.0+

Справочник аргументов

date date
Обязательный

Объект даты и времени (100AD-9999AD). ПРИМЕЧАНИЕ: В Lucee этот параметр называется datetime.

mask string
По умолчанию: `dd-mmm-yyyy HH:nn:ss`

Маска для форматирования даты и времени. - d : День месяца в виде цифры; для однозначных чисел начальный ноль не добавляется. - dd : День месяца в виде цифры; для однозначных чисел добавляется начальный ноль. - EEE : День недели в виде трёхбуквенного сокращения. - EEEE : День недели полностью. - m : Месяц в виде цифры; для однозначных чисел начальный ноль не добавляется. - mm : Месяц в виде цифры; для однозначных чисел добавляется начальный ноль. - mmm : Месяц в виде трёхбуквенного сокращения. (Dec) - mmmm : Месяц полностью. - M : Месяц в году. (до CF2016u3) - D : День в году. (до CF2016u3) - yy : Год в виде двух последних цифр; для годов меньше 10 добавляется начальный ноль. - yyyy : Год в виде четырёх цифр. - YYYY : Номер недели в году в виде четырёх цифр. (до CF2016u3) - Y : Номер недели в году. (до CF2016u3) - YY : Номер недели в году в виде двух последних цифр; для годов меньше 10 добавляется начальный ноль. (до CF2016u3) - G : Строка, обозначающая период/эру. (например, BC/AD) - h : часы; для однозначных значений начальный ноль не добавляется. (12-часовой формат) - hh : часы; для однозначных значений добавляется начальный ноль. (12-часовой формат) - H : часы; для однозначных значений начальный ноль не добавляется. (24-часовой формат) - HH : часы; для однозначных значений добавляется начальный ноль. (24-часовой формат) - n : минуты; для однозначных значений начальный ноль не добавляется. - nn : минуты; для однозначных значений добавляется начальный ноль. - s : секунды; для однозначных значений начальный ноль не добавляется. - ss : секунды; для однозначных значений добавляется начальный ноль. - l или L : миллисекунды без начальных нулей. - t : односимвольная строка обозначения времени, например A или P. - tt : многосимвольная строка обозначения времени, например AM или PM. - w : Неделя года в виде цифры. (JDK7+) - ww : Неделя года в виде цифр; для однозначного номера недели добавляется начальный ноль. (JDK7+) - W : Неделя месяца в виде цифры. (JDK7+) - WW : Неделя месяца в виде цифр; для однозначного номера недели добавляется начальный ноль. (JDK7+)Следующие маски задают формат полной даты и времени и не могут сочетаться с другими масками: - short : эквивалент "m/d/y h:nn tt" - medium : эквивалент "mmm d, yyyy h:nn:ss tt" - long : medium с полным названием месяца, а не его сокращением, за которым следует трёхбуквенное обозначение часового пояса; например, "mmmm d, yyyy h:mm:ss tt EST" - full : эквивалент "EEEE, mmmm d, yyyy h:mm:ss tt EST" - iso CF 2016+ Lucee 5.3.8+ Форматирует дату и время в формате ISO8601 - iso8601 Lucee 4.5+ Форматирует дату и время в формате ISO8601Функция также использует маски даты и времени Java, за исключением маски "a". Дополнительные сведения см. в разделе Date and Time Patterns на странице API SimpleDateFormat Java. В JDK7 и JDK8 добавлены маски "w", "ww", "W" и "WW".

timezone string
По умолчанию: `System time-zone`

Часовой пояс, который следует использовать. Можно указать трёхбуквенный код ("EST","UTC") или полное название (например, "America/New_York")

Совместимость

ColdFusion:

Версия 10+ Функция-член доступна в CF11+.

Lucee:

Версия 4.5+ Похоже, аргумент timezone не преобразует дату из системного часового пояса в указанный, как это происходит в ACF. Функция-член доступна в Lucee5+.

Railo:

Документация этой функции для Railo отсутствует, однако документирована функция LSDateTimeFormat. Используются маски даты и времени Java. Подробности см. в разделе Date and Time Patterns по адресу: http://docs.oracle.com/javase/1.4.2/docs/api/java/text/SimpleDateFormat.html

OpenBD:

Некоторые токены маски отличаются от используемых в Adobe ColdFusion

Ссылки дополнительная информация о dateTimeFormat

SimpleDateFormat — эта функция принимает значения маски, описанные здесь. **ПРИМЕЧАНИЕ:** После CF2016u3 это больше не поддерживается.

Примеры
Примеры кода с вызовом функции dateTimeFormat

Пример маски Short

В Lucee с Java 11 после года добавляется запятая: ошибка LDEV-3744

dateTimeFormat("2015-04-11 19:02", "short")

Ожидаемый результат: 4/11/15 7:02 PM

Пример маски Medium

В Lucee с Java 11 после года добавляется запятая: ошибка LDEV-3744

dateTimeFormat("2015-04-11 19:02", "medium")

Ожидаемый результат: Apr 11, 2015 7:02:00 PM

Пример маски Long

В Lucee с Java 11 перед временем добавляется «at»: ошибка LDEV-3744

dateTimeFormat("2015-04-11 19:02", "long")

Ожидаемый результат: April 11, 2015 7:02:00 PM UTC

Пример маски Full

В Lucee с Java 11 перед временем добавляется «at»: ошибка LDEV-3744

dateTimeFormat("2015-04-11 19:02", "full")

Ожидаемый результат: Saturday, April 11, 2015 7:02:00 PM UTC

Формат даты и времени ISO 8601

В зависимости от движка используется формат CF 2016+ iso или формат Lucee 4.5+ iso8601. Обратите внимание: формат часового пояса может отличаться в зависимости от версии Java (по крайней мере, в Lucee, возможно, из-за LDEV-3744).

dateTimeFormat("2015-04-11 19:02", (server.keyExists("lucee")) ? "iso8601" : "iso")

Ожидаемый результат: 2015-04-11T19:02:00+0000

Синтаксис функции-члена dateTimeFormat

Простое форматирование даты и времени с использованием синтаксиса функции-члена

createDateTime( 2022, 10, 1, 9, 30, 0 ).dateTimeFormat( 'mm/dd/yyyy hh:nn:ss tt' )

Ожидаемый результат: 10/01/2022 09:30:00 AM

© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/datetimeformat