Spec-Zone.ru › ColdFusion

dateFormat

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

dateFormat(date [, mask]) → returns string

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

date.dateFormat([mask])

  • CF
  • Lucee
  • BL 1.0.0+
  • См. также: timeFormat dateTimeFormat lsDateFormat

    Описание аргументов

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

    Объект даты и времени (100–9999 гг. н. э.)

    mask string
    По умолчанию: 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

    Использование маски short

    dateFormat("2015-04-11", "short")

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

    Использование маски long

    dateFormat("2015-04-11", "long")

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

    Использование маски full

    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

    Spec-Zone.ru

    Настройки Оффлайн Что нового Помощь О нас
    Spec-Zone .ru
    спецификации, руководства, описания, API