timeFormat

Форматирует значение времени, используя соглашения форматирования времени, принятые в английском языке США. Если маска не указана, возвращает значение времени в формате hh:mm tt. Для международного форматирования времени см. LSTimeFormat.

timeFormat(time [, mask]) → returns string

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

time.timeFormat([mask])

Lucee

BL 1.0.0+

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

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

Значение даты и времени или строка для преобразования

mask string
По умолчанию: `hh:mm tt`

Символы маски, определяющие формат. h,hh: Часы в 12-часовом формате часов,H,HH: Часы в 24-часовом формате часов m,mm: Минутыs,ss: Секунды l: Миллисекундыt: A или Ptt: AM или PMz: Часовой пояс в буквальном формате, например GMTZ: Часовой пояс со смещением в часах (RFC822), например +0400X,XX,XXX: Часовой пояс со смещением в часах в формате ISO 8601"short": h:mm tt"medium": h:mm:ss tt

Значения:

short
medium
long
full

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

ColdFusion:

Функция-член доступна в CF11+. Маски z Z и X добавлены в CF2016+

Lucee:

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

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

Форматирование времени в 12-часовом формате с AM/PM

timeFormat( createDateTime(2017, 8, 31, 15, 25, 11), "h:mm tt")

Ожидаемый результат: 3:25 PM

Пример функции-члена

Требуется CF 11+ или Lucee 5+

createDateTime(2017, 8, 31, 15, 25, 11).timeFormat("h:mm tt")

Ожидаемый результат: 3:25 PM

Без маски

По умолчанию должна использоваться маска hh:mm tt

timeFormat( createDateTime(2017, 8, 31, 15, 25, 11) )

Ожидаемый результат: 03:25 PM

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