Spec-Zone.ru › ColdFusion

createTimespan

Возвращает значение, определяющее период времени, представленное числом типа double, где 1 равен 1 дню. Его можно прибавлять к другим объектам даты и времени или вычитать из них, а также использовать с атрибутом cachedWithin функции cfquery.

createTimespan(days, hours, minutes, seconds) → returns numeric

  • CF
  • Lucee
  • BL 1.0.0+
  • Ссылка на аргументы

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

    Количество дней от 0 до 32768

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

    Количество часов

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

    Количество минут

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

    Количество секунд

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

    Использование createTimespan в cfquery

    Функция createTimespan полезна для атрибута cachedwithin функции cfquery.

    <cfquery name = "GetParks" datasource = "cfdocexamples" cachedWithin = "#createTimespan(0, 6, 0, 0)#"> 
     SELECT PARKNAME, REGION, STATE 
     FROM Parks 
     ORDER by ParkName, State 
     </cfquery>

    Функция createTimespan возвращает числовое значение

    Передача 6 часов, или четверти дня, возвращает значение типа double, равное 1/4

    createTimespan(0, 6, 0, 0)

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

    Сложение даты и временной метки

    Вместо использования dateAdd можно прибавить временную метку к объекту даты

    dateFormat( createDate(2017,1,1) + createTimespan(2,0,0,0) )

    Ожидаемый результат: 03-Jan-17

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

    Spec-Zone.ru

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