Spec-Zone.ru › ColdFusion

dateAdd

Добавляет единицы времени к дате.

dateAdd(datepart, number, date) → returns date

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

date.add(datepart, number)

  • CF
  • Lucee
  • BL 1.0.0+
  • См. также: dateConvert datePart createTimeSpan createDate dateDiff

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

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

    yyyy - Годq - Кварталm - Месяцy - День годаd - Деньw - День неделиww - Неделяh - Часn - Минутаs - Секундаl - Миллисекунда
    Значения:
    • yyyy
    • q
    • m
    • y
    • d
    • w
    • ww
    • h
    • n
    • s
    • l

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

    Количество единиц datepart, добавляемых к указанной дате. Число должно быть целым. Отрицательные целые числа сдвигают дату в прошлое, положительные — в будущее.

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

    Объект даты и времени в диапазоне от 100 года н. э. до 9999 года н. э. ПРИМЕЧАНИЕ: Если объект даты и времени передается в виде строки, заключите его в кавычки. В противном случае он будет интерпретирован как числовое представление объекта даты и времени.

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

    ColdFusion:

    Функция-член доступна в CF11 и более поздних версиях.

    Lucee:

    Функция-член доступна в Lucee 4.5 и более поздних версиях.

    Примеры
    Пример кода, вызывающего функцию dateAdd

    Добавление дней к дате

    Добавить 30 дней к 3 августа 2014 года.

    dateAdd('d', 30, '8/3/2014')

    Ожидаемый результат: {ts '2014-09-02 00:00:00'}

    Вычитание дней из даты

    Вычесть 30 дней из 3 августа 2014 года.

    dateAdd('d', -30, '8/3/2014')

    Ожидаемый результат: {ts '2014-07-04 00:00:00'}

    Добавление недель к дате

    Здесь мы добавляем 8 недель к дате 3 августа 2014 года.

    dateAdd('ww', 8, '8/3/2014')

    Ожидаемый результат: {ts '2014-09-28 00:00:00'}

    Добавление дней к дате (функция-член)

    Здесь мы добавляем 1 день к текущей дате и времени.

    createDate( 2022, 10, 1 ).add( 'd', 1 )

    Ожидаемый результат: {ts '2022-10-02 00:00:00'}

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

    Spec-Zone.ru

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