dateFormat
Форматирует значение даты, используя американские форматы дат. Для форматирования даты и времени используйте dateTimeFormat. Для поддержки международных форматов дат используйте lsDateFormat.
dateFormat(date [, mask]) → returns string
Синтаксис функции-члена
date.dateFormat([mask])
Описание аргументов
date date Обязательный
Объект даты и времени (100–9999 гг. н. э.)
mask string
По умолчанию: dd-mmm-yy
dd-mmm-yy
Каждое ключевое слово ниже будет заменено в строке соответствующей частью даты: -d: День месяца в виде числа; без ведущего нуля для однозначных значений. -dd: День месяца в виде числа; с ведущим нулём для однозначных значений. -ddd: День недели в виде трёхбуквенного сокращения. -dddd: День недели полностью. -e: День недели (CF2016u3+). -f: День недели в месяце (CF2016u3+). -D: День в году. (до CF2016u3) -m: Месяц в виде числа; без ведущего нуля для однозначных значений. -mm: Месяц в виде числа; с ведущим нулём для однозначных значений. -mmm: Месяц в виде трёхбуквенного сокращения. -mmmm: Месяц полностью. -M: Месяц в году. (до CF2016u3) -k: Час в дне (CF2016u3+). -W: Неделя в месяце (CF2016u3+). -w: Неделя в году (CF2016u3+). -yy: Год в виде последних двух цифр; для годов меньше 10 добавляется ведущий ноль. -yyyy,YYYY: Год в виде четырёх цифр. -gg: Строка периода/эры. -z: Часовой пояс в нестандартизованном сокращённом формате, например,
EST (CF2016u3+). -Z: Часовой пояс в формате смещения в часах (часовой пояс RFC 822), например, +0530 (CF2016u3+). -X: Часовой пояс в формате смещения в часах по ISO 8601. (CF2016u3+). -X: +05 -XX: +0530 -XXX: +5:30 Следующие ключевые слова являются сокращениями для определённых полных форматов и не могут сочетаться с другими масками: -short: эквивалентно m/d/y -medium: эквивалентно mmm d, yyyy -long: эквивалентно mmmm d, yyyy -full: эквивалентно dddd, mmmm d, yyyy Совместимость
ColdFusion:
В CF6+ добавлена поддержка форматов масок
short, medium, long и full. Функция-член доступна в CF11+. Lucee:
Функция-член доступна в Lucee 4.5+.
Ссылки дополнительная информация о dateFormat
- Шпаргалка по dateFormat — показывает маски и результаты их применения.
Примеры Пример кода, вызывающего функцию dateFormat
dateFormat("2015-04-11", "short") Ожидаемый результат: 4/11/15
dateFormat("2015-04-11", "long") Ожидаемый результат: April 11, 2015
dateFormat("2015-04-11", "full") Ожидаемый результат: Saturday, April 11, 2015
createDate( 2022, 10, 1 ).dateFormat( 'mm/dd/yyyy' ) Ожидаемый результат: 10/01/2022
© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/dateformat